@kirigami/php-prepros 1.8.0 → 1.9.1

package/README.md

@@ -109,6 +109,32 @@ 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
+  [`@kirigami/plugin-embed`](https://www.npmjs.com/package/@kirigami/plugin-embed),
+  which replaces the old plain-iframe output with a real oEmbed-backed card
+  (cover thumbnail, title, play button — no network call until the visitor
+  actually clicks play). If a project used the built-in `{% youtube %}`,
+  install the plugin; without it, the tag now falls through unresolved
+  (`{% youtube ID %}` printed as-is) rather than rendering an iframe.
+  `codepen`/`checklist`/`callout` are unaffected.
+
+---
+
 ## What's new in 1.8.0
 
 - **`{% img-asset %}` — a new built-in Markdown plugin.** Same pipeline as the

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kirigami/php-prepros",
-  "version": "1.8.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

@@ -27,21 +27,6 @@ MD::registerPlugin('codepen', function (array $args, string $body): string {
          . "</iframe>";
 });
 
-// --- YouTube (inline) ---
-// {% youtube VIDEO_ID %}
-// {% youtube VIDEO_ID 560 315 %}
-MD::registerPlugin('youtube', function (array $args, string $body): string {
-    $id     = htmlspecialchars($args[0] ?? '', ENT_QUOTES, 'UTF-8');
-    $width  = intval($args[1] ?? 560);
-    $height = intval($args[2] ?? 315);
-    if ($id === '') return '<!-- youtube: missing id -->';
-    return "<iframe width=\"{$width}\" height=\"{$height}\" "
-         . "src=\"https://www.youtube.com/embed/{$id}\" "
-         . "title=\"YouTube video player\" frameborder=\"0\" loading=\"lazy\" "
-         . "allow=\"accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture\" "
-         . "allowfullscreen></iframe>";
-});
-
 // --- Checklist (multi-line block) ---
 // {% checklist
 // Do the dishes
@@ -104,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="">';
 });