Add UI components (#98)

* Rename the converter

* Add the new targets

* Add component files and modifier files

* Add the css files

* Add tests for the comp

* Add the deploy command

* Add the components plugin

* Make the components and the plugin available to use

Author: mattesmohr

Package.swift

@@ -10,7 +10,11 @@ let package = Package(
     products: [
         .library(
             name: "HTMLKit",
-            targets: ["HTMLKit"]
+            targets: ["HTMLKit", "HTMLKitComponents"]
+        ),
+        .plugin(
+            name: "ComponentsPlugin",
+            targets: ["ComponentsPlugin"]
         ),
         .plugin(
             name: "ConverterPlugin",
@@ -31,11 +35,20 @@ let package = Package(
             ]
         ),
         .target(
-            name: "Converter",
+            name: "HTMLKitConverter",
             dependencies: [
                 .target(name: "HTMLKit")
             ]
         ),
+        .target(
+            name: "HTMLKitComponents",
+            dependencies: [
+                .target(name: "HTMLKit")
+            ],
+            resources: [
+                .process("Resources")
+            ]
+        ),
         .testTarget(
             name: "HTMLKitTests",
             dependencies: [
@@ -46,27 +59,58 @@ let package = Package(
             ]
         ),
         .testTarget(
-            name: "ConverterTests",
+            name: "HTMLKitConverterTests",
             dependencies: [
-                .target(name: "Converter")
+                .target(name: "HTMLKitConverter")
             ],
             resources: [
                 .process("Conversion")
             ]
         ),
+        .testTarget(
+            name: "HTMLKitComponentsTests",
+            dependencies: [
+                .target(name: "HTMLKitComponents"),
+                .target(name: "HTMLKit")
+            ]
+        ),
         .executableTarget(
             name: "ConvertCommand",
             dependencies: [
-                .target(name: "Converter")
+                .target(name: "HTMLKitConverter")
             ],
-            path: "Sources/Commands"
+            path: "Sources/Commands/Converter"
+        ),
+        .executableTarget(
+            name: "DeployCommand",
+            dependencies: [
+                .target(name: "HTMLKitComponents")
+            ],
+            path: "Sources/Commands/Components"
         ),
         .plugin(
             name: "ConverterPlugin",
-            capability: .command(intent: .custom(verb: "convert", description: "Convert html content"), permissions: [.writeToPackageDirectory(reason: "The command needs the permission to create the converted file.")]),
+            capability: .command(
+                intent: .custom(
+                    verb: "convert",
+                    description: "Convert html content"),
+                permissions: [.writeToPackageDirectory(reason: "The command needs the permission to create the converted file.")]
+            ),
             dependencies: [
                 .target(name: "ConvertCommand")
             ]
+        ),
+        .plugin(
+            name: "ComponentsPlugin",
+            capability: .command(
+                intent: .custom(
+                    verb: "deploy",
+                    description: "Deploy css files"),
+                permissions: [.writeToPackageDirectory(reason: "The command needs the permission to create the minified css file.")]
+            ),
+            dependencies: [
+                .target(name: "DeployCommand")
+            ]
         )
     ]
 )

Plugins/ComponentsPlugin/plugin.swift

@@ -0,0 +1,71 @@
+import PackagePlugin
+import Foundation
+
+@main
+struct ConverterPlugin: CommandPlugin {
+    
+    func performCommand(context: PluginContext, arguments: [String]) async throws {
+        
+        let tool = try context.tool(named: "DeployCommand")
+        
+        var extractor = ArgumentExtractor(arguments)
+        
+        let usageArgument = extractor.extractFlag(named: "command-usage")
+        
+        if usageArgument > 0 {
+            
+            let explanation = """
+            USAGE: deploy
+            """
+            
+            print(explanation)
+            
+        } else {
+
+            var processArguments = [String]()
+            
+            if let dependency = try context.dependency(named: "HTMLKit") {
+                
+                if let target = try? dependency.package.targets(named: ["HTMLKitComponents"]).first {
+                    processArguments.insert(target.directory.string, at: 0)
+                    
+                } else {
+                    Diagnostics.error("Missing package.")
+                }
+                
+            } else {
+                Diagnostics.error("Missing package.")
+            }
+            
+            processArguments.insert(context.package.directory.string, at: 1)
+            
+            print("The deploy starts...")
+            
+            let process = try Process.run(URL(fileURLWithPath: tool.path.string), arguments: processArguments)
+            process.waitUntilExit()
+            
+            if process.terminationReason == .exit && process.terminationStatus == 0 {
+                print("The deploy has finished.")
+                
+            } else {
+                Diagnostics.error("The deploy has failed: \(process.terminationReason)")
+            }
+            
+        }
+    }
+}
+
+extension PluginContext {
+    
+    public func dependency(named: String) throws -> PackageDependency? {
+        
+        for dependency in self.package.dependencies {
+            
+            if dependency.package.displayName == named {
+                return dependency
+            }
+        }
+        
+        return nil
+    }
+}

Sources/Commands/Components/DeployCommand.swift

@@ -0,0 +1,64 @@
+import Foundation
+
+@main
+internal struct DeployCommand {
+    
+    private static var sourcePath: String {
+        return CommandLine.arguments[1]
+    }
+    
+    private static var targetPath: String {
+        return CommandLine.arguments[2]
+    }
+    
+    internal static func main() throws {
+        
+        if !FileManager.default.fileExists(atPath: sourcePath) {
+            print("No valid source path.")
+            
+            exit(1)
+            
+        } else {
+            
+            let resourcesDirectory = URL(fileURLWithPath: sourcePath)
+                .appendingPathComponent("Resources", isDirectory: true)
+            
+            let distributionFile = URL(fileURLWithPath: targetPath)
+                .appendingPathComponent("Public")
+                .appendingPathComponent("css")
+                .appendingPathComponent("all")
+                .appendingPathExtension("css")
+            
+            if let enumerator = FileManager.default.enumerator(at: resourcesDirectory, includingPropertiesForKeys: nil, options: [.skipsHiddenFiles]) {
+                
+                for case let path as URL in enumerator {
+                    
+                    if !path.hasDirectoryPath {
+                        
+                        if !path.isFileURL {
+                            enumerator.skipDescendants()
+                            
+                        } else {
+                            
+                            let data = try Data(contentsOf: path)
+                            
+                            if let handle = try? FileHandle(forWritingTo: distributionFile) {
+                                
+                                handle.seekToEndOfFile()
+                                
+                                handle.write(data)
+                                
+                                handle.closeFile()
+                                
+                            } else {
+                                try data.write(to: distributionFile)
+                            }
+                        }
+                    }
+                }
+            }
+            
+            exit(0)
+        }
+    }
+}

Sources/Commands/Converter/ConvertCommand.swift

@@ -1,5 +1,5 @@
 import Foundation
-import Converter
+import HTMLKitConverter
 
 @main
 @available(macOS 11.0, *)

Sources/HTMLKitComponents/Actions.swift

@@ -0,0 +1,40 @@
+/*
+ Abstract:
+ The file contains the actions for the components.
+ */
+
+public enum Actions {
+    
+    case show(_ target: String)
+    case hide(_ target: String)
+    case animate(_ target: String)
+    
+    public var script: String {
+        
+        switch self {
+        case .show(let target):
+            return show(target)
+            
+        case .hide(let target):
+            return hide(target)
+            
+        case .animate(let target):
+            return animate(target)
+        }
+    }
+    
+    private func show(_ target: String) -> String {
+        
+        return "$('#\(target)').show();"
+    }
+    
+    private func hide(_ target: String) -> String {
+        
+        return "$('#\(target)').hide();"
+    }
+    
+    private func animate(_ target: String) -> String {
+        
+        return "$('#\(target)').animate();"
+    }
+}