chore: add future cocoapods docc support preparation

Author: soumyamahunt

DynamicCodableKit.podspec

@@ -28,8 +28,13 @@ Pod::Spec.new do |s|
   s.watchos.deployment_target = '2.0'
   s.osx.deployment_target = '10.10'
 
-  s.source_files = "Sources/#{s.name}/**/*.swift"
+  s.source_files = "Sources/#{s.name}/**/*.swift", "Sources/#{s.name}/*.docc"
   s.preserve_paths = "{Sources,Tests}/#{s.name}*/**/*", "*.md"
+  s.pod_target_xcconfig = {
+    'CLANG_WARN_DOCUMENTATION_COMMENTS' => 'YES',
+    'RUN_DOCUMENTATION_COMPILER' => 'YES'
+  }
+
   s.test_spec do |ts|
     ts.source_files = "Tests/#{s.name}Tests/**/*.swift"
     ts.resources = "Tests/#{s.name}Tests/**/*.json"

Helpers/DynamicCodableKit.podspec

@@ -29,4 +29,10 @@ Pod::Spec.new do |s|
   s.osx.deployment_target = '10.10'
 
   s.vendored_frameworks = "#{s.name}.xcframework"
+  # @todo: Enable when CocoaPods starts supporting docc
+  # s.source_files = "#{s.name}.docc"
+  # s.pod_target_xcconfig = {
+  #   'CLANG_WARN_DOCUMENTATION_COMMENTS' => 'YES',
+  #   'RUN_DOCUMENTATION_COMPILER' => 'YES'
+  # }
 end

Scripts/archive.js

@@ -48,6 +48,7 @@ xcframeworkGlobberer.on(
     const output = fs.createWriteStream(`${archiveName}.xcframework.zip`);
     const archive = archiver('zip');
     archive.directory(m.absolute, xcframework);
+    archive.directory(`Sources/${name}/${name}.docc`, `${name}.docc`);
     archive.file('package.json');
     archive.file('LICENSE');
     archive.file(`Helpers/${name}.podspec`, { name: `${name}.podspec` });

Scripts/build-doc.js

@@ -2,7 +2,6 @@
 const fs = require('node:fs');
 const path = require('node:path');
 const process = require('node:process');
-const semver = require('semver');
 const archiver = require('archiver');
 const readdirGlob = require('readdir-glob');
 const { execSync } = require('node:child_process');

package-lock.json

@@ -20,8 +20,7 @@
         "archiver": "^5.3.1",
         "conventional-changelog-conventionalcommits": "^4.6.3",
         "open": "^8.4.0",
-        "plist": "^3.0.5",
-        "semver": "^7.3.7"
+        "plist": "^3.0.5"
     },
     "scripts": {
         "build": "Scripts/build.js",