@kirigami/php-prepros 1.0.0

package/src/libraries/md.class.php

@@ -0,0 +1,444 @@
+<?php
+
+class MD {
+
+    // ========================================================================
+    // SYSTÈME DE PLUGINS
+    //
+    // SYNTAXE INLINE (args sur la même ligne) :
+    //   {% nom_plugin arg1 arg2 "arg avec espaces" %}
+    //
+    // SYNTAXE BLOC (contenu multi-ligne) :
+    //   {% nom_plugin arg1 arg2
+    //   ligne de contenu 1
+    //   ligne de contenu 2
+    //   %}
+    //
+    // Le callback reçoit toujours (array $args, string $body) :
+    //   - $args  : tableau des arguments passés sur la ligne d'ouverture
+    //   - $body  : contenu multi-ligne (vide "" pour les tags inline)
+    //
+    // Exemples :
+    //   GithubReadmeParser::registerPlugin('codepen', function(array $args, string $body): string {
+    //       $id = htmlspecialchars($args[0] ?? '', ENT_QUOTES, 'UTF-8');
+    //       return "<iframe src=\"https://codepen.io/embed/{$id}\"></iframe>";
+    //   });
+    //
+    //   GithubReadmeParser::registerPlugin('checklist', function(array $args, string $body): string {
+    //       $items = array_filter(explode("\n", trim($body)));
+    //       $html  = '<ul class="checklist">';
+    //       foreach ($items as $item) {
+    //           $html .= '<li><input type="checkbox" /> ' . htmlspecialchars(trim($item), ENT_QUOTES, 'UTF-8') . '</li>';
+    //       }
+    //       return $html . '</ul>';
+    //   });
+    // ========================================================================
+
+    /** @var array<string, callable(string[]): string> */
+    private static array $plugins = [];
+
+    /**
+     * Enregistre un plugin par son nom.
+     *
+     * @param string   $name     Nom du tag, ex: "codepen"
+     * @param callable $callback function(array $args): string
+     *                           $args[0] = premier argument, $args[1] = second, etc.
+     */
+    public static function registerPlugin(string $name, callable $callback): void {
+        self::$plugins[strtolower(trim($name))] = $callback;
+    }
+
+    /**
+     * Supprime un plugin enregistré.
+     */
+    public static function unregisterPlugin(string $name): void {
+        unset(self::$plugins[strtolower(trim($name))]);
+    }
+
+    /**
+     * Retourne la liste des plugins enregistrés.
+     *
+     * @return string[]
+     */
+    public static function getRegisteredPlugins(): array {
+        return array_keys(self::$plugins);
+    }
+
+    // ========================================================================
+
+    public static function toHtml(string $markdown): string {
+
+        // ====================================================================
+        // ÉTAPE 1 : Normalisation des fins de ligne
+        // ====================================================================
+        $html = str_replace(["\r\n", "\r"], "\n", $markdown);
+
+
+        // ====================================================================
+        // ÉTAPE 2 : PLUGINS
+        // Deux formes supportées :
+        //
+        //   INLINE : {% nom arg1 "arg 2" %}
+        //     → $args = ['arg1', 'arg 2'], $body = ''
+        //
+        //   BLOC   : {% nom arg1\ncontenu\nsur\nplusieurs lignes\n%}
+        //     → $args = ['arg1'], $body = "contenu\nsur\nplusieurs lignes"
+        //
+        // Les deux sont capturés par une seule regex qui distingue la présence
+        // d'un saut de ligne après les args (bloc) ou non (inline).
+        // Traités avant l'encodage XSS — réinjectés en toute dernière étape.
+        // ====================================================================
+        $pluginBlocks = [];
+
+        /**
+         * Parse une chaîne d'arguments en tableau.
+         * Supporte les mots simples, "guillemets doubles" et 'simples'.
+         */
+        $parseArgs = static function (string $rawArgs): array {
+            $args = [];
+            if (trim($rawArgs) === '') return $args;
+            preg_match_all(
+                '/"([^"\\\\]*(?:\\\\.[^"\\\\]*)*)"|\'([^\'\\\\]*(?:\\\\.[^\'\\\\]*)*)\'|(\S+)/',
+                $rawArgs,
+                $m
+            );
+            foreach ($m[0] as $i => $_) {
+                $args[] = $m[1][$i] !== ''
+                    ? stripslashes($m[1][$i])
+                    : ($m[2][$i] !== ''
+                        ? stripslashes($m[2][$i])
+                        : $m[3][$i]);
+            }
+            return $args;
+        };
+
+        $html = preg_replace_callback(
+            // Groupe 1 : nom du plugin
+            // Groupe 2 : args inline (tout ce qui est sur la première ligne après le nom)
+            // Groupe 3 : corps multi-ligne (présent seulement pour les tags blocs)
+            '/\{%\s*([a-zA-Z0-9_-]+)([^\n%]*?)(?:\n([\s\S]*?))?\s*%\}/m',
+            function ($matches) use (&$pluginBlocks, $parseArgs): string {
+                $name    = strtolower(trim($matches[1]));
+                $args    = $parseArgs(trim($matches[2] ?? ''));
+                // $matches[3] existe uniquement si le tag est multi-ligne
+                $body    = isset($matches[3]) ? trim($matches[3]) : '';
+
+                if (!isset(self::$plugins[$name])) {
+                    // Plugin inconnu : préservé encodé plutôt que silencieusement supprimé
+                    return htmlspecialchars($matches[0], ENT_QUOTES, 'UTF-8');
+                }
+
+                $output      = (self::$plugins[$name])($args, $body);
+                $placeholder = "\x02PLG" . count($pluginBlocks) . "\x03";
+                $pluginBlocks[$placeholder] = $output;
+                return $placeholder;
+            },
+            $html
+        );
+
+
+        // ====================================================================
+        // ÉTAPE 3 : BLOCS DE CODE (```lang ... ```)
+        // ====================================================================
+        $codeBlocks = [];
+        $html = preg_replace_callback('/^```([a-zA-Z0-9_+-]*)\n([\s\S]*?)\n^```/m', function ($matches) use (&$codeBlocks) {
+            $lang        = !empty($matches[1]) ? ' class="language-' . htmlspecialchars($matches[1], ENT_QUOTES, 'UTF-8') . '"' : '';
+            $code        = htmlspecialchars($matches[2], ENT_QUOTES, 'UTF-8');
+            $placeholder = "\x02CB" . count($codeBlocks) . "\x03";
+            $codeBlocks[$placeholder] = "<pre><code{$lang}>{$code}</code></pre>";
+            return $placeholder;
+        }, $html);
+
+        // Code inline (`...`)
+        $inlineCodes = [];
+        $html = preg_replace_callback('/`([^`\n]+)`/', function ($matches) use (&$inlineCodes) {
+            $code        = htmlspecialchars($matches[1], ENT_QUOTES, 'UTF-8');
+            $placeholder = "\x02IC" . count($inlineCodes) . "\x03";
+            $inlineCodes[$placeholder] = "<code>{$code}</code>";
+            return $placeholder;
+        }, $html);
+
+
+        // ====================================================================
+        // ÉTAPE 3b : ALERTES GFM ET BLOCKQUOTES
+        // Traités avant l'encodage XSS car le caractère > serait encodé en &gt;
+        // et les regex ne matcheraient plus.
+        // ====================================================================
+        $blockquotes = [];
+
+        // Alertes GFM (> [!NOTE], etc.) — plus spécifique, traité en premier
+        $html = preg_replace_callback(
+            '/^(>\s*\[!(NOTE|TIP|IMPORTANT|WARNING|CAUTION)\]\n(?:>[ \t]?[^\n]*\n?)*)/m',
+            function ($matches) use (&$blockquotes): string {
+                $type    = strtolower($matches[2]);
+                $label   = htmlspecialchars($matches[2], ENT_QUOTES, 'UTF-8');
+                $content = preg_replace('/^>\s?\[!(?:NOTE|TIP|IMPORTANT|WARNING|CAUTION)\]\n?/m', '', $matches[1]);
+                $content = preg_replace('/^>[ \t]?/m', '', $content);
+                $content = htmlspecialchars(trim($content), ENT_QUOTES, 'UTF-8');
+                $placeholder = "\x02BQ" . count($blockquotes) . "\x03";
+                $blockquotes[$placeholder] = "<div class=\"markdown-alert markdown-alert-{$type}\">"
+                    . "<p class=\"markdown-alert-title\">{$label}</p>"
+                    . "<p>{$content}</p></div>";
+                return $placeholder;
+            },
+            $html
+        );
+
+        // Blockquotes standards
+        $html = preg_replace_callback('/^((?:>[ \t]?[^\n]*\n?)+)/m', function ($matches) use (&$blockquotes): string {
+            $content = preg_replace('/^>[ \t]?/m', '', $matches[1]);
+            // Les deux espaces trailing sont laissés tels quels : toHtml() les gère lui-même
+            $inner   = self::toHtml(trim($content));
+            $placeholder = "\x02BQ" . count($blockquotes) . "\x03";
+            $blockquotes[$placeholder] = "<blockquote>{$inner}</blockquote>";
+            return $placeholder;
+        }, $html);
+
+
+        // ====================================================================
+        // ÉTAPE 4 : Encodage XSS global
+        // ====================================================================
+        $html = htmlspecialchars($html, ENT_NOQUOTES, 'UTF-8');
+
+
+        // ====================================================================
+        // ÉTAPE 5 : TABLEAUX GFM
+        // Supporte les lignes avec ou sans pipe final (| col | ou | col)
+        // ====================================================================
+        $html = preg_replace_callback(
+            '/^(\|[^\n]+\|?\n)([ \t]*\|[ \t]*:?-+:?[ \t]*(?:\|[ \t]*:?-+:?[ \t]*)*\|?\n)((?:\|[^\n]+\|?\n?)+)/m',
+            function ($matches) {
+                $parseRow = function (string $line): array {
+                    return array_values(array_filter(
+                        array_map('trim', explode('|', trim($line, "| \t\n")))
+                    ));
+                };
+
+                $headers = $parseRow($matches[1]);
+                $alignments = [];
+                $sepCells = $parseRow($matches[2]);
+                foreach ($sepCells as $sep) {
+                    $left  = str_starts_with(trim($sep), ':');
+                    $right = str_ends_with(trim($sep), ':');
+                    if ($left && $right) $alignments[] = ' style="text-align:center"';
+                    elseif ($right)      $alignments[] = ' style="text-align:right"';
+                    elseif ($left)       $alignments[] = ' style="text-align:left"';
+                    else                 $alignments[] = '';
+                }
+
+                $out = "<table>\n  <thead>\n    <tr>\n";
+                foreach ($headers as $i => $header) {
+                    $align = $alignments[$i] ?? '';
+                    $out  .= "      <th{$align}>{$header}</th>\n";
+                }
+                $out .= "    </tr>\n  </thead>\n  <tbody>\n";
+
+                $bodyLines = array_filter(explode("\n", trim($matches[3])));
+                foreach ($bodyLines as $line) {
+                    $cells = $parseRow($line);
+                    $out  .= "    <tr>\n";
+                    foreach ($cells as $i => $cell) {
+                        $align = $alignments[$i] ?? '';
+                        $out  .= "      <td{$align}>{$cell}</td>\n";
+                    }
+                    $out .= "    </tr>\n";
+                }
+                $out .= "  </tbody>\n</table>";
+                return $out;
+            },
+            $html
+        );
+
+
+        // ====================================================================
+        // ÉTAPE 6 : (Alertes GFM et blockquotes traités à l'étape 3b)
+        // ====================================================================
+
+
+        // ====================================================================
+        // ÉTAPE 7 : LISTES DE TÂCHES (GFM checkboxes)
+        // ====================================================================
+        $html = preg_replace('/^[ \t]*[-*+] \[ \] (.+)$/m',    '<li class="task-item"><input type="checkbox" disabled /> $1</li>', $html);
+        $html = preg_replace('/^[ \t]*[-*+] \[[xX]\] (.+)$/m', '<li class="task-item"><input type="checkbox" checked disabled /> $1</li>', $html);
+
+
+        // ====================================================================
+        // ÉTAPE 8 : TITRES (ATX : # à ######)
+        // ====================================================================
+        $html = preg_replace_callback('/^(#{1,6})[ \t]+(.+?)(?:[ \t]+#+)?$/m', function ($matches) {
+            $level = strlen($matches[1]);
+            $text  = trim($matches[2]);
+            $id    = strtolower(preg_replace('/[^\w\- ]/u', '', $text));
+            $id    = preg_replace('/\s+/', '-', trim($id));
+            return "<h{$level} id=\"{$id}\">{$text}</h{$level}>";
+        }, $html);
+
+
+        // ====================================================================
+        // ÉTAPE 9 : LISTES (puces et ordonnées)
+        // ====================================================================
+        $html = preg_replace_callback(
+            '/^([ \t]*\d+\. .+(?:\n[ \t]*\d+\. .+)*)/m',
+            function ($matches) {
+                $items = preg_split('/\n/', trim($matches[1]));
+                $out   = "<ol>\n";
+                foreach ($items as $item) {
+                    $text = preg_replace('/^[ \t]*\d+\. /', '', $item);
+                    $out .= "  <li>{$text}</li>\n";
+                }
+                return $out . "</ol>";
+            },
+            $html
+        );
+
+        $html = preg_replace_callback(
+            '/^([ \t]*[-*+] (?!\[[ xX]\] ).+(?:\n[ \t]*[-*+] (?!\[[ xX]\] ).+)*)/m',
+            function ($matches) {
+                $items = preg_split('/\n/', trim($matches[1]));
+                $out   = "<ul>\n";
+                foreach ($items as $item) {
+                    $text = preg_replace('/^[ \t]*[-*+] /', '', $item);
+                    $out .= "  <li>{$text}</li>\n";
+                }
+                return $out . "</ul>";
+            },
+            $html
+        );
+
+        $html = preg_replace_callback(
+            '/(?:<li class="task-item">.*<\/li>\n?)+/s',
+            function ($matches) {
+                return "<ul class=\"task-list\">\n" . $matches[0] . "</ul>\n";
+            },
+            $html
+        );
+
+
+        // ====================================================================
+        // ÉTAPE 10 : TEXTE EN LIGNE (Gras, Italique, Barré)
+        // ====================================================================
+        $html = preg_replace('/\*\*\*(.+?)\*\*\*/s', '<strong><em>$1</em></strong>', $html);
+        $html = preg_replace('/___(.+?)___/s',        '<strong><em>$1</em></strong>', $html);
+        $html = preg_replace('/\*\*(.+?)\*\*/s',      '<strong>$1</strong>',          $html);
+        $html = preg_replace('/__(.+?)__/s',           '<strong>$1</strong>',          $html);
+        $html = preg_replace('/\*(.+?)\*/s',                          '<em>$1</em>',                  $html);
+        // Le _ italique ne doit matcher qu'aux frontières de mots pour ne pas
+        // capturer les snake_case, noms de packages (@php-wasm/node), etc.
+        $html = preg_replace('/(?<!\w)_([^_\n]+)_(?!\w)/',           '<em>$1</em>',                  $html);
+        $html = preg_replace('/~~(.+?)~~/s',           '<del>$1</del>',                $html);
+
+
+        // ====================================================================
+        // ÉTAPE 11 : LIENS & IMAGES
+        // Les liens externes (https?://) reçoivent target="_blank" + rel="noopener noreferrer".
+        // Les liens internes (/page, #anchor, ../truc) n'en reçoivent pas.
+        // ====================================================================
+        $html = preg_replace(
+            '/!\[([^\]]*)\]\(([^)\s]+)(?:\s+"([^"]*)")?\)/',
+            '<img src="$2" alt="$1" title="$3" loading="lazy" />',
+            $html
+        );
+
+        // Liens markdown [texte](url "titre optionnel")
+        $html = preg_replace_callback(
+            '/\[([^\]]+)\]\(([^)\s]+)(?:\s+"([^"]*)")?\)/',
+            function ($m): string {
+                $text   = $m[1];
+                $href   = $m[2];
+                $title  = isset($m[3]) && $m[3] !== '' ? ' title="' . $m[3] . '"' : '';
+                $extern = preg_match('/^https?:\/\//i', $href)
+                    ? ' target="_blank" rel="noopener noreferrer"'
+                    : '';
+                return "<a href=\"{$href}\"{$title}{$extern}>{$text}</a>";
+            },
+            $html
+        );
+
+        // Liens automatiques <https://...>
+        $html = preg_replace(
+            '/<(https?:\/\/[^>]+)>/',
+            '<a href="$1" target="_blank" rel="noopener noreferrer">$1</a>',
+            $html
+        );
+
+        // URL nues https://...
+        $html = preg_replace(
+            '/(?<!["\'=>])\b(https?:\/\/[^\s<>"\')\]]+)/',
+            '<a href="$1" target="_blank" rel="noopener noreferrer">$1</a>',
+            $html
+        );
+
+
+        // ====================================================================
+        // ÉTAPE 12 : LIGNES SÉPARATRICES
+        // ====================================================================
+        $html = preg_replace('/^(?:[-*_][ \t]*){3,}$/m', '<hr />', $html);
+
+
+        // ====================================================================
+        // ÉTAPE 13 : PARAGRAPHES
+        // Stratégie : on traite ligne par ligne. Les lignes qui commencent par
+        // une balise block-level ou un placeholder sont laissées telles quelles.
+        // Les lignes de texte brut consécutives sont accumulées puis wrappées
+        // dans un <p> quand on rencontre une ligne block ou une ligne vide.
+        // ====================================================================
+        $blockStartTags = ['<h', '<pre', '<ul', '<ol', '<li', '<table', '<thead', '<tbody',
+                           '<tr', '<td', '<th', '<blockquote', '<div', '<hr', '<img',
+                           '</ul>', '</ol>', '</table>', '</blockquote>', '</div>',
+                           "\x02CB", "\x02IC", "\x02PLG", "\x02BQ"];
+
+        $isBlockLine = static function (string $line) use ($blockStartTags): bool {
+            $t = ltrim($line);
+            if ($t === '') return false;
+            foreach ($blockStartTags as $tag) {
+                if (str_starts_with($t, $tag)) return true;
+            }
+            return false;
+        };
+
+        $lines      = explode("\n", $html);
+        $output     = [];
+        $textBuffer = [];
+
+        $flushBuffer = static function () use (&$textBuffer, &$output): void {
+            if (empty($textBuffer)) return;
+            $content = implode("\n", $textBuffer);
+            if (trim($content) !== '') {
+                // Deux espaces en fin de ligne → <br> (convention markdown standard)
+                $content = preg_replace('/  $/m', '<br>', $content);
+                // Saut de ligne simple → espace (comportement GitHub)
+                // Sauf si déjà converti en <br> ci-dessus
+                $content = preg_replace('/(?<!r>)\n/', ' ', $content);
+                $output[] = '<p>' . trim($content) . '</p>';
+            }
+            $textBuffer = [];
+        };
+
+        foreach ($lines as $line) {
+            if ($isBlockLine($line)) {
+                $flushBuffer();
+                $output[] = $line;
+            } elseif (trim($line) === '') {
+                // Ligne vide = séparateur de paragraphe
+                $flushBuffer();
+            } else {
+                $textBuffer[] = $line;
+            }
+        }
+        $flushBuffer();
+
+        $html = implode("\n", $output);
+
+
+        // ====================================================================
+        // ÉTAPE 14 : Réinjecter les placeholders
+        // ====================================================================
+        $html = strtr($html, $pluginBlocks);
+        $html = strtr($html, $blockquotes);
+        $html = strtr($html, $codeBlocks);
+        $html = strtr($html, $inlineCodes);
+
+        return $html;
+    }
+}
+

package/src/libraries/md.plugins.php

@@ -0,0 +1,86 @@
+<?php
+
+
+
+// =============================================================================
+// PLUGINS FOURNIS PAR DÉFAUT (optionnels, décommentez ce dont vous avez besoin)
+// =============================================================================
+
+// --- CodePen (inline) ---
+// {% codepen PENid %}
+// {% codepen PENid user height %}
+MD::registerPlugin('codepen', function (array $args, string $body): string {
+    $id     = htmlspecialchars($args[0] ?? '', ENT_QUOTES, 'UTF-8');
+    $user   = htmlspecialchars($args[1] ?? 'anonymous', ENT_QUOTES, 'UTF-8');
+    $height = intval($args[2] ?? 400);
+    if ($id === '') return '<!-- codepen: id manquant -->';
+    return "<iframe height=\"{$height}\" style=\"width:100%\" "
+         . "scrolling=\"no\" "
+         . "src=\"https://codepen.io/{$user}/embed/{$id}?default-tab=result\" "
+         . "frameborder=\"no\" loading=\"lazy\" allowfullscreen>"
+         . "</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: id manquant -->';
+    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 (bloc multi-ligne) ---
+// {% checklist
+// Faire la vaisselle
+// Promener le chien
+// Lire un livre
+// %}
+//
+// Optionnellement avec un titre :
+// {% checklist "Mes tâches du jour"
+// Tâche 1
+// Tâche 2
+// %}
+MD::registerPlugin('checklist', function (array $args, string $body): string {
+    $title = !empty($args[0]) ? '<p class="checklist-title"><strong>' . htmlspecialchars($args[0], ENT_QUOTES, 'UTF-8') . '</strong></p>' : '';
+    $items = array_filter(array_map('trim', explode("\n", $body)));
+    if (empty($items)) return '<!-- checklist: aucun élément -->';
+    $html = "<div class=\"checklist\">{$title}<ul>\n";
+    foreach ($items as $item) {
+        $html .= '  <li><label><input type="checkbox" /> ' . htmlspecialchars($item, ENT_QUOTES, 'UTF-8') . '</label></li>' . "\n";
+    }
+    return $html . "</ul></div>";
+});
+
+// --- Avertissement personnalisé (inline ou bloc) ---
+// Inline :  {% callout warning "Attention !" Contenu sur une ligne %}
+// Bloc   :  {% callout danger "Titre"
+//            Paragraphe 1
+//
+//            Paragraphe 2
+//            %}
+MD::registerPlugin('callout', function (array $args, string $body): string {
+    $validTypes = ['info', 'success', 'warning', 'danger'];
+    $type  = in_array($args[0] ?? '', $validTypes, true) ? $args[0] : 'info';
+    $title = !empty($args[1]) ? htmlspecialchars($args[1], ENT_QUOTES, 'UTF-8') : '';
+
+    // Contenu : $body si tag bloc, sinon les args restants sur la ligne d'ouverture
+    if ($body !== '') {
+        $content = htmlspecialchars($body, ENT_QUOTES, 'UTF-8');
+        // Remplace les doubles sauts de ligne par des <br><br> pour préserver les paragraphes
+        $content = str_replace("\n\n", '<br><br>', $content);
+        $content = str_replace("\n", '<br>', $content);
+    } else {
+        $content = htmlspecialchars(implode(' ', array_slice($args, $title ? 2 : 1)), ENT_QUOTES, 'UTF-8');
+    }
+
+    $titleHtml = $title ? "<strong>{$title}</strong><br>" : '';
+    return "<div class=\"callout callout-{$type}\">{$titleHtml}{$content}</div>";
+});

package/src/libraries/obf.class.php

@@ -0,0 +1,23 @@
+<?php
+
+class OBF {
+	
+
+	public static function encode(mixed $obj): string {
+		$json = json_encode($obj);
+		$base64 = base64_encode($json);
+		$rot13 = str_rot13($base64);
+		$deflate = gzencode($rot13);
+		return substr($deflate, 2);
+	}
+
+
+	public static function decode(string $str): mixed {
+		$inflate = gzdecode("\x1f\x8b" . $str);
+		$base64 = str_rot13($inflate);
+		$json = base64_decode($base64);
+		$data = json_decode($json);
+		return $data;
+	}
+
+}