Update docs, polish for release

Author: MGatner

README.md

@@ -65,3 +65,30 @@ public $routes = [
 This tells the library to load the Bootstrap assets for every route (`''`) without having
 to move it from its pre-bundled subdirectory. It also will load any assets in the `dropzone`
 directory for the specified route.
+
+## Publishing
+
+**Assets** can publish resources for you. This is particularly helpful if you need files
+from a vendor package but don't want to host the package in your **public/** folder.
+The **Manifests** library uses manifest files to locate and copy matching assets into your
+assets folder (defined by `$config->fileBase`). This library includes a convenience command
+to assist with asset publication:
+
+	php spark assets:publish
+
+By default `assets:publish` will scan all namespaces for JSON files in **{namespaceRoot}/Manifests**
+and (assuming they are valid) will publish the assets defined there. Behavior is
+customizable using **Config/Assets.php** but the default is to copy assets into
+**public/assets/vendor/** into the subdirectory defined in the manifest.
+
+If you are using version control it is recommended to exclude your asset publish directory,
+for example by adding **public/assets/vendor/** to your **.gitignore** file.
+
+### Manifests
+
+Manifests are JSON files with at least the following three properties:
+* `source` - The directory (relative to `$config->publishBase`) of the assets
+* `destination` - The directory (relative to `$config->fileBase`) for the assets
+* `resources` - The list of resources to publish, each with at least its own `source`.
+
+See [examples/](examples/) for some example manifest files.

bin/Assets.php

@@ -26,7 +26,7 @@ class Assets extends \Tatter\Assets\Config\Assets
 	public $webBase = 'https://example.com/assets/';
 
 	// Starting directory for manifest publication
-	public $publishBase = ROOTPATH;
+	public $publishBase = ROOTPATH . 'vendor/';
 
 	// Additional paths to load per route
 	// Relative to fileBase, no leading/trailing slashes

src/Config/Assets.php

@@ -17,7 +17,7 @@ class Assets extends BaseConfig
 	public $webBase = 'assets/';
 
 	// Starting directory for manifest publication
-	public $publishBase = ROOTPATH;
+	public $publishBase = ROOTPATH . 'vendor/';
 
 	// Additional paths to load per route
 	// Relative to fileBase, no leading/trailing slashes

src/Config/Services.php

@@ -20,4 +20,20 @@ public static function assets(BaseConfig $config = null, bool $getShared = true)
 		}
 		return new \Tatter\Assets\Libraries\Assets($config);
 	}
+	
+    public static function manifests(BaseConfig $config = null, bool $getShared = true)
+    {
+		if ($getShared)
+		{
+			return static::getSharedInstance('manifests', $config);
+		}
+
+		// If no config was injected then load one
+		// Prioritizes app/Config if found
+		if (empty($config))
+		{
+			$config = config('Assets');
+		}
+		return new \Tatter\Assets\Libraries\Manifests($config);
+	}
 }

src/Libraries/Manifests.php

@@ -30,10 +30,12 @@ public function __construct($config = null)
 		helper('filesystem');
 	}
 
-	// Scan all namespaces for manifest files
+	// Clear and return status messages
 	public function getMessages(): array
 	{
-		return $this->messages;
+		$messages = $this->messages;
+		$this->messages = [];
+		return $messages;
 	}
 
 	// Scan all namespaces for manifest files
@@ -195,7 +197,7 @@ protected function ensureDirectory($directory): bool
 		// Check for existence
 		if (! file_exists($directory))
 		{
-			mkdir($directory, 0644, true);
+			mkdir($directory, 0755, true);
 		}
 
 		// Make sure there's a directory there now