Merge branch 'release/v0.15.1'

.github/workflows/integrate.yml

@@ -24,15 +24,15 @@ jobs:
           ini-values: "post_max_size=256M"
 
       - name: "Checkout code"
-        uses: "actions/checkout@v3"
+        uses: "actions/checkout@v4"
 
       - name: Install Effigy
         run: |
           composer global config --no-plugins allow-plugins.phpstan/extension-installer true
           composer global require decodelabs/effigy
 
       - name: "Install dependencies"
-        uses: "ramsey/composer-install@v2"
+        uses: "ramsey/composer-install@v3"
         with:
           dependency-versions: "highest"
 
@@ -72,7 +72,7 @@ jobs:
           ini-values: "post_max_size=256M"
 
       - name: "Checkout code"
-        uses: "actions/checkout@v3"
+        uses: "actions/checkout@v4"
 
       - name: Install Effigy
         run: |
@@ -83,7 +83,7 @@ jobs:
         run: "composer validate --strict"
 
       - name: "Install dependencies"
-        uses: "ramsey/composer-install@v2"
+        uses: "ramsey/composer-install@v3"
         with:
           dependency-versions: "highest"
 
@@ -106,7 +106,7 @@ jobs:
           ini-values: "post_max_size=256M"
 
       - name: "Checkout code"
-        uses: "actions/checkout@v3"
+        uses: "actions/checkout@v4"
 
       - name: "Check EditorConfig configuration"
         run: "test -f .editorconfig"
@@ -120,7 +120,7 @@ jobs:
           composer global require decodelabs/effigy
 
       - name: "Install dependencies"
-        uses: "ramsey/composer-install@v2"
+        uses: "ramsey/composer-install@v3"
         with:
           dependency-versions: "highest"
 

CHANGELOG.md

@@ -1,3 +1,7 @@
+## v0.15.1 (2024-06-20)
+* Added ViewAssetContainer structure
+* Added initial Asset implementations
+
 ## v0.15.0 (2024-05-07)
 * Added JsonSerializable to Markup interface
 

src/Asset.php

@@ -0,0 +1,18 @@
+<?php
+
+/**
+ * @package Tagged
+ * @license http://opensource.org/licenses/MIT
+ */
+
+declare(strict_types=1);
+
+namespace DecodeLabs\Tagged;
+
+use DecodeLabs\Collections\AttributeContainer;
+
+interface Asset extends AttributeContainer
+{
+    public function getPriority(): int;
+    public function render(): Element;
+}

src/Asset/InlineScript.php

@@ -0,0 +1,69 @@
+<?php
+
+/**
+ * @package Tagged
+ * @license http://opensource.org/licenses/MIT
+ */
+
+declare(strict_types=1);
+
+namespace DecodeLabs\Tagged\Asset;
+
+use DecodeLabs\Coercion;
+use DecodeLabs\Tagged\AssetTrait;
+use DecodeLabs\Tagged\Element;
+
+class RemoteScript implements Script
+{
+    use AssetTrait;
+
+    protected string $source;
+
+    /**
+     * Init with script
+     *
+     * @param array<string, mixed> $attributes
+     */
+    public function __construct(
+        int $priority,
+        string $source,
+        array $attributes = []
+    ) {
+        $this->priority = $priority;
+        $this->source = $source;
+
+        if (!isset($attributes['type'])) {
+            $attributes['type'] = 'text/javascript';
+        }
+
+        $this->setAttributes($attributes);
+    }
+
+    /**
+     * Set type
+     */
+    public function setType(
+        string $type
+    ): void {
+        $this->setAttribute('type', $type);
+    }
+
+    /**
+     * Get type
+     */
+    public function getType(): string
+    {
+        return Coercion::toString(
+            $this->getAttribute('type') ?? 'text/javascript'
+        );
+    }
+
+    /**
+     * Render
+     */
+    public function render(): Element
+    {
+        unset($this->attributes['src']);
+        return new Element('script', $this->source, $this->attributes);
+    }
+}

src/Asset/Link.php

@@ -0,0 +1,105 @@
+<?php
+
+/**
+ * @package Tagged
+ * @license http://opensource.org/licenses/MIT
+ */
+
+declare(strict_types=1);
+
+namespace DecodeLabs\Tagged\Asset;
+
+use DecodeLabs\Coercion;
+use DecodeLabs\Tagged\Asset;
+use DecodeLabs\Tagged\AssetTrait;
+use DecodeLabs\Tagged\Element;
+
+class Link implements Asset
+{
+    use AssetTrait;
+
+    /**
+     * Init with URL
+     *
+     * @param array<string, mixed> $attributes
+     */
+    public function __construct(
+        int $priority,
+        string $href,
+        array $attributes = []
+    ) {
+        $this->priority = $priority;
+        $attributes['href'] = $href;
+
+        if (!isset($attributes['rel'])) {
+            $attributes['rel'] = 'stylesheet';
+        }
+
+        $this->setAttributes($attributes);
+    }
+
+    /**
+     * Set URL
+     */
+    public function setHref(
+        string $href
+    ): void {
+        $this->setAttribute('href', $href);
+    }
+
+    /**
+     * Get URL
+     */
+    public function getHref(): string
+    {
+        return Coercion::toString(
+            $this->getAttribute('href')
+        );
+    }
+
+    /**
+     * Set rel
+     */
+    public function setRel(
+        string $rel
+    ): void {
+        $this->setAttribute('rel', $rel);
+    }
+
+    /**
+     * Get rel
+     */
+    public function getRel(): string
+    {
+        return Coercion::toString(
+            $this->getAttribute('rel') ?? 'stylesheet'
+        );
+    }
+
+    /**
+     * Set type
+     */
+    public function setType(
+        string $type
+    ): void {
+        $this->setAttribute('type', $type);
+    }
+
+    /**
+     * Get type
+     */
+    public function getType(): ?string
+    {
+        return Coercion::toStringOrNull(
+            $this->getAttribute('type')
+        );
+    }
+
+    /**
+     * Render
+     */
+    public function render(): Element
+    {
+        return new Element('link', null, $this->attributes);
+    }
+}

src/Asset/RemoteScript.php

@@ -0,0 +1,120 @@
+<?php
+
+/**
+ * @package Tagged
+ * @license http://opensource.org/licenses/MIT
+ */
+
+declare(strict_types=1);
+
+namespace DecodeLabs\Tagged\Asset;
+
+use DecodeLabs\Coercion;
+use DecodeLabs\Tagged\AssetTrait;
+use DecodeLabs\Tagged\Element;
+
+class RemoteScript implements Script
+{
+    use AssetTrait;
+
+    /**
+     * Init with URL
+     *
+     * @param array<string, mixed> $attributes
+     */
+    public function __construct(
+        int $priority,
+        string $src,
+        array $attributes = []
+    ) {
+        $this->priority = $priority;
+        $attributes['src'] = $src;
+
+        if (!isset($attributes['type'])) {
+            $attributes['type'] = 'text/javascript';
+        }
+
+        $this->setAttributes($attributes);
+    }
+
+    /**
+     * Set URL
+     */
+    public function setSrc(
+        string $src
+    ): void {
+        $this->setAttribute('src', $src);
+    }
+
+    /**
+     * Get URL
+     */
+    public function getSrc(): string
+    {
+        return Coercion::toString(
+            $this->getAttribute('src')
+        );
+    }
+
+    /**
+     * Set async
+     */
+    public function setAsync(
+        bool $async
+    ): void {
+        $this->setAttribute('async', $async);
+    }
+
+    /**
+     * Is async
+     */
+    public function isAsync(): bool
+    {
+        return Coercion::toBool($this->getAttribute('async') ?? false);
+    }
+
+    /**
+     * Set deferred
+     */
+    public function setDeferred(
+        bool $deferred
+    ): void {
+        $this->setAttribute('defer', $deferred);
+    }
+
+    /**
+     * Is deferred
+     */
+    public function isDeferred(): bool
+    {
+        return Coercion::toBool($this->getAttribute('defer') ?? false);
+    }
+
+    /**
+     * Set type
+     */
+    public function setType(
+        string $type
+    ): void {
+        $this->setAttribute('type', $type);
+    }
+
+    /**
+     * Get type
+     */
+    public function getType(): string
+    {
+        return Coercion::toString(
+            $this->getAttribute('type') ?? 'text/javascript'
+        );
+    }
+
+
+    /**
+     * Render
+     */
+    public function render(): Element
+    {
+        return new Element('script', null, $this->attributes);
+    }
+}

src/Asset/Script.php

@@ -0,0 +1,16 @@
+<?php
+
+/**
+ * @package Tagged
+ * @license http://opensource.org/licenses/MIT
+ */
+
+declare(strict_types=1);
+
+namespace DecodeLabs\Tagged\Asset;
+
+use DecodeLabs\Tagged\Asset;
+
+interface Script extends Asset
+{
+}