@kirigami/php-prepros 1.7.2 → 1.8.0

package/README.md

@@ -109,6 +109,26 @@ Part of the **Kirigami** project ecosystem.
 
 ---
 
+## What's new in 1.8.0
+
+- **`{% img-asset %}` — a new built-in Markdown plugin.** Same pipeline as the
+  `<img asset>` HTML tag (`IMG::asset()`: resize, cache, publish under
+  `image.dest`), usable straight from Markdown text:
+
+  ```
+  {% img-asset photo.jpg %}
+  {% img-asset photo.jpg 800 %}
+  {% img-asset photo.jpg 800 600 %}
+  {% img-asset photo.jpg 800 600 cover %}
+  ```
+
+  Positional args: source path (relative to `image.source`), width, height,
+  and the literal `cover` keyword. Registered in `md.plugins.php` alongside
+  `codepen`/`youtube`/`checklist`/`callout` — available out of the box, drop
+  it with `MD::unregisterPlugin('img-asset')` if you don't want it.
+
+---
+
 ## What's new in 1.7.2
 
 - **Cleaner formatted output around highlighted code.** The de-indent script

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kirigami/php-prepros",
-  "version": "1.7.2",
+  "version": "1.8.0",
   "description": "PHP preprocessor for the Kirigami static site generator. Compile PHP page templates to clean, deployable HTML — with zero server dependency.",
   "keywords": [
     "kirigami",

package/src/libraries/md.plugins.php

@@ -89,4 +89,21 @@ MD::registerPlugin('callout', function (array $args, string $body): string {
 
     $titleHtml = $title ? "<strong>{$title}</strong><br>" : '';
     return "<div class=\"callout callout-{$type}\">{$titleHtml}{$content}</div>";
+});
+
+// --- Image asset (inline) — same pipeline as <img asset>, via IMG::asset() ---
+// {% img-asset photo.jpg %}
+// {% img-asset photo.jpg 800 %}
+// {% img-asset photo.jpg 800 600 %}
+// {% img-asset photo.jpg 800 600 cover %}
+MD::registerPlugin('img-asset', function (array $args, string $body): string {
+    $path = trim($args[0] ?? '');
+    if ($path === '') return '<!-- img-asset: missing path -->';
+
+    $width  = isset($args[1]) ? (int) $args[1] : 0;
+    $height = isset($args[2]) ? (int) $args[2] : 0;
+    $cover  = isset($args[3]) && strtolower($args[3]) === 'cover';
+
+    $src = IMG::asset($path, $width, $height, $cover, PREPROS::$file);
+    return '<img src="' . htmlspecialchars($src, ENT_QUOTES, 'UTF-8') . '" alt="">';
 });