Merge pull request #504 from KnpLabs/v2-unstable-wkhtmltopdf-global-o…

…ptions

V2 unstable wkhtmltopdf global options

src/Backend/WkHtmlToPdf/ExtraOption/CopiesOption.php

@@ -8,6 +8,9 @@
 
 final class CopiesOption implements ExtraOption
 {
+    /**
+     * @param positive-int $number
+     */
     public function __construct(private readonly int $number) {}
 
     public function compile(): array

src/Backend/WkHtmlToPdf/ExtraOption/DpiOption.php

@@ -8,6 +8,9 @@
 
 final class DpiOptions implements ExtraOption
 {
+    /**
+     * @param positive-int $dpi
+     */
     public function __construct(private readonly int $dpi) {}
 
     public function compile(): array

src/Backend/WkHtmlToPdf/ExtraOption/GrayscaleOption.php

@@ -4,7 +4,9 @@
 
 namespace KNPLabs\Snappy\Backend\WkHtmlToPdf\ExtraOption;
 
-final class GrayscaleOption
+use KNPLabs\Snappy\Backend\WkHtmlToPdf\ExtraOption;
+
+final class GrayscaleOption implements ExtraOption
 {
     public function __construct() {}
 

src/Backend/WkHtmlToPdf/ExtraOption/ImageDpiOption.php

@@ -4,7 +4,17 @@
 
 namespace KNPLabs\Snappy\Backend\WkHtmlToPdf\ExtraOption;
 
-final class ImageDpiOption
+use KNPLabs\Snappy\Backend\WkHtmlToPdf\ExtraOption;
+
+final class ImageDpiOption implements ExtraOption
 {
+    /**
+     * @param positive-int $dpi
+     */
     public function __construct(public readonly int $dpi) {}
+
+    public function compile(): array
+    {
+        return ['--image-dpi', $this->dpi];
+    }
 }

src/Backend/WkHtmlToPdf/ExtraOption/ImageQualityOption.php

@@ -0,0 +1,20 @@
+<?php
+
+declare(strict_types=1);
+
+namespace KNPLabs\Snappy\Backend\WkHtmlToPdf\ExtraOption;
+
+use KNPLabs\Snappy\Backend\WkHtmlToPdf\ExtraOption;
+
+final class ImageQualityOption implements ExtraOption
+{
+    /**
+     * @param positive-int $quality
+     */
+    public function __construct(public readonly int $quality) {}
+
+    public function compile(): array
+    {
+        return ['--image-quality', $this->quality];
+    }
+}

src/Backend/WkHtmlToPdf/ExtraOption/LowQualityOption.php

@@ -0,0 +1,17 @@
+<?php
+
+declare(strict_types=1);
+
+namespace KNPLabs\Snappy\Backend\WkHtmlToPdf\ExtraOption;
+
+use KNPLabs\Snappy\Backend\WkHtmlToPdf\ExtraOption;
+
+final class LowQualityOption implements ExtraOption
+{
+    public function __construct() {}
+
+    public function compile(): array
+    {
+        return ['--lowquality'];
+    }
+}

src/Backend/WkHtmlToPdf/ExtraOption/MarginBottomOption.php

@@ -0,0 +1,17 @@
+<?php
+
+declare(strict_types=1);
+
+namespace KNPLabs\Snappy\Backend\WkHtmlToPdf\ExtraOption;
+
+use KNPLabs\Snappy\Backend\WkHtmlToPdf\ExtraOption;
+
+final class MarginBottomOption implements ExtraOption
+{
+    public function __construct(public readonly string $margin) {}
+
+    public function compile(): array
+    {
+        return ['--margin-bottom', $this->margin];
+    }
+}

src/Backend/WkHtmlToPdf/ExtraOption/MarginLeftOption.php

@@ -0,0 +1,17 @@
+<?php
+
+declare(strict_types=1);
+
+namespace KNPLabs\Snappy\Backend\WkHtmlToPdf\ExtraOption;
+
+use KNPLabs\Snappy\Backend\WkHtmlToPdf\ExtraOption;
+
+final class MarginLeftOption implements ExtraOption
+{
+    public function __construct(public readonly string $margin) {}
+
+    public function compile(): array
+    {
+        return ['--margin-left', $this->margin];
+    }
+}

src/Backend/WkHtmlToPdf/ExtraOption/MarginRightOption.php

@@ -0,0 +1,17 @@
+<?php
+
+declare(strict_types=1);
+
+namespace KNPLabs\Snappy\Backend\WkHtmlToPdf\ExtraOption;
+
+use KNPLabs\Snappy\Backend\WkHtmlToPdf\ExtraOption;
+
+final class MarginRightOption implements ExtraOption
+{
+    public function __construct(public readonly string $margin) {}
+
+    public function compile(): array
+    {
+        return ['--margin-right', $this->margin];
+    }
+}

src/Backend/WkHtmlToPdf/ExtraOption/MarginTopOption.php

@@ -0,0 +1,17 @@
+<?php
+
+declare(strict_types=1);
+
+namespace KNPLabs\Snappy\Backend\WkHtmlToPdf\ExtraOption;
+
+use KNPLabs\Snappy\Backend\WkHtmlToPdf\ExtraOption;
+
+final class MarginTopOption implements ExtraOption
+{
+    public function __construct(public readonly string $margin) {}
+
+    public function compile(): array
+    {
+        return ['--margin-top', $this->margin];
+    }
+}

src/Backend/WkHtmlToPdf/ExtraOption/NoCollateOption.php

@@ -4,7 +4,14 @@
 
 namespace KNPLabs\Snappy\Backend\WkHtmlToPdf\ExtraOption;
 
-final class NoCollateOption
+use KNPLabs\Snappy\Backend\WkHtmlToPdf\ExtraOption;
+
+final class NoCollateOption implements ExtraOption
 {
     public function __construct() {}
+
+    public function compile(): array
+    {
+        return ['--no-collate'];
+    }
 }

src/Backend/WkHtmlToPdf/ExtraOption/NoPdfCompressionOption.php

@@ -0,0 +1,17 @@
+<?php
+
+declare(strict_types=1);
+
+namespace KNPLabs\Snappy\Backend\WkHtmlToPdf\ExtraOption;
+
+use KNPLabs\Snappy\Backend\WkHtmlToPdf\ExtraOption;
+
+final class NoPdfCompressionOption implements ExtraOption
+{
+    public function __construct() {}
+
+    public function compile(): array
+    {
+        return ['--no-pdf-compression'];
+    }
+}

src/Backend/WkHtmlToPdf/ExtraOption/Orientation/Value.php

@@ -0,0 +1,11 @@
+<?php
+
+declare(strict_types=1);
+
+namespace KNPLabs\Snappy\Backend\WkHtmlToPdf\ExtraOption\Orientation;
+
+enum Value: string
+{
+    case PORTRAIT = 'Portrait';
+    case LANDSCAPE = 'Landscape';
+}

src/Backend/WkHtmlToPdf/ExtraOption/OrientationOption.php

@@ -0,0 +1,28 @@
+<?php
+
+declare(strict_types=1);
+
+namespace KNPLabs\Snappy\Backend\WkHtmlToPdf\ExtraOption;
+
+use KNPLabs\Snappy\Backend\WkHtmlToPdf\ExtraOption;
+use KNPLabs\Snappy\Core\Backend\Options\PageOrientation;
+
+final class OrientationOption implements ExtraOption
+{
+    public function __construct(private readonly ExtraOption\Orientation\Value $orientation) {}
+
+    public static function fromPageOrientation(PageOrientation $pageOrientation): self
+    {
+        return new self(
+            match ($pageOrientation) {
+                PageOrientation::PORTRAIT => ExtraOption\Orientation\Value::PORTRAIT,
+                PageOrientation::LANDSCAPE => ExtraOption\Orientation\Value::LANDSCAPE,
+            }
+        );
+    }
+
+    public function compile(): array
+    {
+        return ['--orientation', $this->orientation->value];
+    }
+}

src/Backend/WkHtmlToPdf/ExtraOption/PageHeightOption.php

@@ -0,0 +1,17 @@
+<?php
+
+declare(strict_types=1);
+
+namespace KNPLabs\Snappy\Backend\WkHtmlToPdf\ExtraOption;
+
+use KNPLabs\Snappy\Backend\WkHtmlToPdf\ExtraOption;
+
+final class PageHeightOption implements ExtraOption
+{
+    public function __construct(public readonly string $height) {}
+
+    public function compile(): array
+    {
+        return ['--page-height', $this->height];
+    }
+}

src/Backend/WkHtmlToPdf/ExtraOption/PageSizeOption.php

@@ -0,0 +1,17 @@
+<?php
+
+declare(strict_types=1);
+
+namespace KNPLabs\Snappy\Backend\WkHtmlToPdf\ExtraOption;
+
+use KNPLabs\Snappy\Backend\WkHtmlToPdf\ExtraOption;
+
+final class PageSizeOption implements ExtraOption
+{
+    public function __construct(public readonly string $size) {}
+
+    public function compile(): array
+    {
+        return ['--page-size', $this->size];
+    }
+}

src/Backend/WkHtmlToPdf/ExtraOption/PageWidthOption.php

@@ -0,0 +1,17 @@
+<?php
+
+declare(strict_types=1);
+
+namespace KNPLabs\Snappy\Backend\WkHtmlToPdf\ExtraOption;
+
+use KNPLabs\Snappy\Backend\WkHtmlToPdf\ExtraOption;
+
+final class PageWidthOption implements ExtraOption
+{
+    public function __construct(public readonly string $width) {}
+
+    public function compile(): array
+    {
+        return ['--page-width', $this->width];
+    }
+}

src/Backend/WkHtmlToPdf/ExtraOption/TitleOption.php

@@ -0,0 +1,17 @@
+<?php
+
+declare(strict_types=1);
+
+namespace KNPLabs\Snappy\Backend\WkHtmlToPdf\ExtraOption;
+
+use KNPLabs\Snappy\Backend\WkHtmlToPdf\ExtraOption;
+
+final class TitleOption implements ExtraOption
+{
+    public function __construct(public readonly string $title) {}
+
+    public function compile(): array
+    {
+        return ['--title', $this->title];
+    }
+}

src/Backend/WkHtmlToPdf/ExtraOption/UseXserverOption.php

@@ -0,0 +1,17 @@
+<?php
+
+declare(strict_types=1);
+
+namespace KNPLabs\Snappy\Backend\WkHtmlToPdf\ExtraOption;
+
+use KNPLabs\Snappy\Backend\WkHtmlToPdf\ExtraOption;
+
+final class UseXserverOption implements ExtraOption
+{
+    public function __construct() {}
+
+    public function compile(): array
+    {
+        return ['--use-xserver'];
+    }
+}

src/Backend/WkHtmlToPdf/Options/GlobalOptions.php

@@ -0,0 +1,22 @@
+<?php
+
+declare(strict_types=1);
+
+namespace KNPLabs\Snappy\Backend\WkHtmlToPdf\Options;
+
+use KNPLabs\Snappy\Backend\WkHtmlToPdf\OptionGroup;
+use KNPLabs\Snappy\Backend\WkHtmlToPdf\Options\GlobalOptions\CollateOption;
+use KNPLabs\Snappy\Backend\WkHtmlToPdf\Options\GlobalOptions\CookieJarOption;
+use KNPLabs\Snappy\Backend\WkHtmlToPdf\Options\GlobalOptions\NoCollateOption;
+use KNPLabs\Snappy\Core\Backend\Options\PageOrientation;
+
+final class GlobalOptions extends OptionGroup
+{
+    public function __construct(
+        public readonly ?CollateOption $collate,
+        public readonly ?NoCollateOption $noCollate,
+        public readonly ?CookieJarOption $cookieJar,
+        public readonly ?PageOrientation $pageOrientation,
+    ) {
+    }
+}

src/Backend/WkHtmlToPdf/Options/GlobalOptions/CollateOption.php

@@ -0,0 +1,17 @@
+<?php
+
+declare(strict_types=1);
+
+namespace KNPLabs\Snappy\Backend\WkHtmlToPdf\Options\GlobalOptions;
+
+use KNPLabs\Snappy\Backend\WkHtmlToPdf\Option;
+
+final class CollateOption implements Option
+{
+    public function __construct() {}
+
+    public function compile(): array
+    {
+        return ['--collate'];
+    }
+}

src/Backend/WkHtmlToPdf/Options/GlobalOptions/CookieJarOption.php

@@ -0,0 +1,15 @@
+<?php
+
+declare(strict_types=1);
+
+namespace KNPLabs\Snappy\Backend\WkHtmlToPdf\Options\GlobalOptions;
+
+final class CookieJarOption
+{
+    public function __construct(public readonly string $path) {}
+
+    public function compile(): array
+    {
+        return ['--no-collate'];
+    }
+}