@kirigami/php-prepros 1.9.0 → 1.9.1

package/README.md

@@ -109,6 +109,19 @@ Part of the **Kirigami** project ecosystem.
 
 ---
 
+## What's new in 1.9.1
+
+- **`{% img-asset %}` no longer crashes the build on an unresolvable path.**
+  `IMG::asset()`'s exception is now caught and turned into an HTML comment,
+  matching `codepen`/`checklist`'s own missing-argument behavior instead of
+  aborting the whole render. This also makes it safe to *document* the tag —
+  a literal `` `{% img-asset path … %}` `` written as prose inside a code
+  span still runs the plugin (code-span protection only swaps the *displayed*
+  output back to the literal text; the callback itself always executes), so
+  a placeholder path used to throw "Invalid image file." and fail the build.
+
+---
+
 ## What's new in 1.9.0
 
 - **`{% youtube %}` removed** — moved to

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kirigami/php-prepros",
-  "version": "1.9.0",
+  "version": "1.9.1",
   "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,6 +89,15 @@ MD::registerPlugin('img-asset', function (array $args, string $body): string {
     $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);
+    // A resolvable path is required to actually call IMG::asset() — this
+    // also protects a literal `{% img-asset path … %}` written as Markdown
+    // *documentation* (inside a code span): the plugin still runs even when
+    // its output ends up discarded for the literal text, so a placeholder
+    // path must not throw.
+    try {
+        $src = IMG::asset($path, $width, $height, $cover, PREPROS::$file);
+    } catch (Throwable $e) {
+        return '<!-- img-asset: ' . htmlspecialchars($e->getMessage(), ENT_QUOTES, 'UTF-8') . ' -->';
+    }
     return '<img src="' . htmlspecialchars($src, ENT_QUOTES, 'UTF-8') . '" alt="">';
 });