@kirigami/php-prepros 1.1.0 → 1.6.0

package/src/utils/getfilestats.js

@@ -0,0 +1,30 @@
+import { stat } from 'node:fs/promises';
+
+/**
+ * Gets a file's information.
+ * @param {string} filePath - the file path
+ * @returns {Promise<object>} object holding the file's info
+ */
+async function getFileStats(filePath) {
+	try {
+		const stats = await stat(filePath);
+
+		return {
+			exists: true,
+			isFile: stats.isFile(),
+			isDirectory: stats.isDirectory(),
+			size: stats.size, // in bytes
+			createdAt: stats.birthtime,
+			modifiedAt: stats.mtime,
+			accessedAt: stats.atime,
+			changedAt: stats.ctime, // last metadata change
+		};
+	} catch (error) {
+		if (error.code === 'ENOENT') {
+			return { exists: false };
+		}
+		throw error; // other errors (permissions, etc.)
+	}
+}
+
+export default getFileStats;

package/src/utils/isbinary.js

@@ -1,5 +1,5 @@
-// Table de magic bytes compilée une seule fois au module load
-// Clé = premier octet, valeur = liste de signatures [octets, longueur à lire]
+// Magic-bytes table compiled once at module load
+// Key = first byte, value = list of signatures [bytes, length to read]
 const MAGIC_MAP = new Map([
 	[0x89, [[[0x89, 0x50, 0x4E, 0x47]]]],           // PNG
 	[0xFF, [[[0xFF, 0xD8, 0xFF]], [[0xFF, 0xFE]]]],  // JPEG, UTF-16 LE (text BOM)
@@ -14,20 +14,20 @@ const MAGIC_MAP = new Map([
 	[0x00, [[[0x00, 0x00, 0xFE, 0xFF]]]],             // UTF-32 BE BOM (text!)
 ]);
 
-// BOMs texte → jamais binaire, early exit immédiat
+// Text BOMs → never binary, immediate early exit
 const TEXT_BOMS = new Set([
 	'\xEF\xBB\xBF',   // UTF-8
 	'\xFF\xFE',        // UTF-16 LE
 	'\xFE\xFF',        // UTF-16 BE
 ]);
 
-const SAMPLE_SIZE = 512; // 8 Ko c'est inutile pour un mount local
+const SAMPLE_SIZE = 512; // 8 KB is overkill for a local mount
 
 /**
- * Détection binaire en 3 passes avec early exit agressif.
- * Optimisé pour être appelé sur des centaines de fichiers au démarrage.
+ * 3-pass binary detection with aggressive early exit.
+ * Optimized to be called on hundreds of files at startup.
  *
- * @param {Buffer} buf - Buffer du fichier (readFileSync)
+ * @param {Buffer} buf - the file's Buffer (readFileSync)
  * @returns {boolean}
  */
 function isBinary(buf) {
@@ -36,16 +36,16 @@ function isBinary(buf) {
 
 	const b0 = buf[0];
 
-	// Passe 1 — Magic bytes (O(1), max 4 comparaisons)
+	// Pass 1 — Magic bytes (O(1), max 4 comparisons)
 	const candidates = MAGIC_MAP.get(b0);
 	if (candidates) {
 		for (const sigs of candidates) {
 			for (const sig of sigs) {
 				if (sig.every((b, i) => buf[i] === b)) {
-					// BOM texte → sortie immédiate "text"
+					// Text BOM → immediate "text" exit
 					if (b0 === 0xEF || b0 === 0xFE || (b0 === 0xFF && buf[1] === 0xFE)) return false;
 					if (b0 === 0x00 && buf[1] === 0x00) return false; // UTF-32
-					return true; // Binaire confirmé
+					return true; // Binary confirmed
 				}
 			}
 		}
@@ -53,17 +53,17 @@ function isBinary(buf) {
 
 	const sample = Math.min(len, SAMPLE_SIZE);
 
-	// Passe 2 — Octet NUL (signal binaire quasi-certain, très fréquent dans les binaires)
-	// indexOf est natif C++ → beaucoup plus rapide qu'une boucle JS
+	// Pass 2 — NUL byte (a near-certain binary signal, very common in binaries)
+	// indexOf is native C++ → much faster than a JS loop
 	if (buf.indexOf(0x00, 0, 'binary') !== -1 &&
 		buf.indexOf(0x00) < sample) return true;
 
-	// Passe 3 — Ratio statistique sur l'échantillon
+	// Pass 3 — Statistical ratio over the sample
 	let nonText = 0;
 	for (let i = 0; i < sample; i++) {
 		const b = buf[i];
 		if (b < 0x20) {
-			// Caractères de contrôle légitimes en texte
+			// Control characters that are legitimate in text
 			if (b !== 0x09 && b !== 0x0A && b !== 0x0D && b !== 0x0C && b !== 0x1B) {
 				nonText++;
 			}

package/src/utils.inc.php

@@ -1,11 +1,4 @@
 <?php
-ini_set('log_errors', 1);
-ini_set('html_errors', 0);
-ini_set('display_errors', 1);
-ini_set('error_reporting', 32767);
-ini_set('error_log', 'php://stderr');
-error_reporting(E_ALL);
-
 
 const BR = '<br>';
 const RN = "\r\n";
@@ -14,35 +7,53 @@ const R = "\r";
 const N = "\n";
 
 
-function _print_r(mixed $obj) {
+function _print_r(mixed $obj, bool $ret = false) {
+    if($ret) return '<pre>' . print_r($obj, $ret) . '</pre>';
     echo '<pre>' . print_r($obj, true) . '</pre>';
 }
 
 
 spl_autoload_register(function ($class) {
     static $catalog = [
+
+        // Out of the box
         'ARR'             => 'arr.class.php',    
         'CACHE'           => 'cache.class.php',
         'CURL'            => 'curl.class.php',
 		'FS'              => 'fs.class.php',
         'HTML'            => 'html.class.php',
         'IMG'             => 'img.class.php',
+        'LD'              => 'ld.class.php',
         'MD'              => 'md.class.php',
+        'NORM'            => 'norm.class.php',
         'OBF'             => 'obf.class.php',
 		'PREPROS'         => 'prepros.class.php',
+        'SCHEMA'          => 'schema.class.php',
 		'SCRAPER'         => 'scraper.class.php',
         'STD'             => 'std.class.php',
         'STR'             => 'str.class.php',
         'YAML'            => 'yaml.class.php',
+
+        // Fallbacks
+        'Normalizer'      => 'normalizer.class.php'
     ];
     if (isset($catalog[$class])) require_once(__DIR__ . '/libraries/' . $catalog[$class]);
 }, true, true);
 
 
+
 $argv = array_merge(['prepros.php'], json_decode(getenv('PREPROS_ARGS'), true));
 $config = json_decode(getenv('PREPROS_CONFIG'));
 date_default_timezone_set($config->timezone);
 chdir('/project');
 
+require_once(__DIR__ . '/libraries/aliases.inc.php');
+
+PREPROS::loadConfig($config);
 
-PREPROS::loadConfig($config);
+// Bootstrap is done: config loaded, `includes` pulled in, aliases available.
+// Fires once per process, before any page renders, for every entrypoint
+// (prepros.php, runenv.php, imagebatch.php). A plugin registered from an
+// `includes` file (or prepros.plugins.php) can hook here to pull in extra
+// PHP files or wire itself up.
+PREPROS::runHook('boot', $config);