feat: added outputStylesheetPath option (#203)

* feat: added outputStylesheetPath option

* fix: accept 0 as padding value instead of using default padding

README.md

@@ -26,6 +26,7 @@ The plugin supports both relative and absolute paths on input file, but can curr
 | `padding` | The amount of space in pixels to put around images in the sprite. _**Note:**_ This value will be scaled proportionally for retina images. | `20` |
 | `outputDimensions` | Whether to also output the pixel `height` and `width` of the image. | `false` |
 | `algorithm` | The [layout algorithm](https://github.com/twolfson/layout) spritesmith should use. | `binary-tree` |
+| `outputStylesheetPath` | Optional. Path of the final CSS file. If defined, sprite urls are relative to this path. | `undefined` |
 
 ## Input example
 

lib/plugin-options.js

@@ -30,7 +30,10 @@ const pluginOptions = {
 
     // If custom options have not been defined by the user, add reasonable
     // default ones.
-    this.opts.padding = customOptions.padding || DEFAULT_PADDING;
+    this.opts.padding =
+      customOptions.padding === undefined
+        ? DEFAULT_PADDING
+        : customOptions.padding;
 
     this.opts.algorithm =
       customOptions.algorithm && isValidSpriteLayout(customOptions.algorithm)
@@ -52,6 +55,10 @@ const pluginOptions = {
       customOptions.spritePath || ''
     );
 
+    this.opts.outputStylesheetPath = customOptions.outputStylesheetPath
+      ? path.resolve(process.cwd(), customOptions.outputStylesheetPath)
+      : undefined;
+
     return this.opts;
   },
 

lib/update-references.js

@@ -114,7 +114,10 @@ function updateReferences(images, sprites, css) {
 
     // Generate the correct reference to the sprite.
     image.spriteRef = path
-      .relative(image.stylesheetPath, image.spritePath)
+      .relative(
+        opts.outputStylesheetPath || image.stylesheetPath,
+        image.spritePath
+      )
       .split(path.sep)
       .join('/');