@kirigami/php-prepros 1.7.0 → 1.7.1

package/README.md

@@ -34,6 +34,7 @@ Part of the **Kirigami** project ecosystem.
 - [@kirigami/php-prepros](#kirigamiphp-prepros)
   - [Overview](#overview)
   - [Table of contents](#table-of-contents)
+  - [What's new in 1.7.1](#whats-new-in-171)
   - [What's new in 1.7.0](#whats-new-in-170)
   - [What's new in 1.6.0](#whats-new-in-160)
   - [What's new in 1.4.0](#whats-new-in-140)
@@ -107,6 +108,16 @@ Part of the **Kirigami** project ecosystem.
 
 ---
 
+## What's new in 1.7.1
+
+- **No side effects on import.** `kirigami.yaml` is now loaded on first use
+  (`render()` / `sitemap()` / `runenv()` / `processImages()`), not while the
+  module is being imported. `import '@kirigami/php-prepros'` from a directory
+  with no project no longer throws — which is what made `kiri build --help` /
+  `kiri export --help` / `kiri run --help` crash instead of printing their help.
+
+---
+
 ## What's new in 1.7.0
 
 - **`META`** class — a `<head>` SEO / social metadata generator, the companion

package/package.json

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

@@ -12,16 +12,25 @@ const __modules = new Map;
 const __project = process.cwd();
 const __dirname = path.dirname(fileURLToPath(import.meta.url));
 const __configpath = path.join(__project, 'kirigami.yaml');
-let   __root = null;
-let   __php  = null;
-
-
-if (!fs.existsSync(__configpath)) throw `Config file not found: ${__configpath}`;
-const config = await walkFile(__configpath);
-if(!config) throw `Invalid config file: ${__configpath}`;
+let   __root   = null;
+let   __php    = null;
+let   __config = null;
+
+
+// Load and cache kirigami.yaml on first use. Deferred (not run at import) so
+// `import '@kirigami/php-prepros'` has no side effects — e.g. `kiri build -h`
+// can pull the module in with no project on disk.
+const loadConfig = async () => {
+    if (__config) return __config;
+    if (!fs.existsSync(__configpath)) throw `Config file not found: ${__configpath}`;
+    __config = await walkFile(__configpath);
+    if (!__config) throw `Invalid config file: ${__configpath}`;
+    return __config;
+}
 
 
 const getPHPInstance = async () => {
+    const config = await loadConfig();
     if(!__php) {
         if(config?.kirigami?.root === undefined) throw `Missing prepros:root property in config file: ${__configpath}`;
         __root = path.join(__project, config.kirigami.root);
@@ -100,6 +109,7 @@ const getPHPInstance = async () => {
 
 
 const mountPath = async (localPath, virtualDir, php) => {
+    const config = await loadConfig();
     php = php || await getPHPInstance();
     if(!path.isAbsolute(localPath)) localPath = path.join(__project, localPath);
     virtualDir = virtualDir || path.posix.join('/project', localPath.replace(__project + path.sep, ''));
@@ -251,6 +261,7 @@ const processImages = async (jobs = []) => {
 
 
 const render = async (file = '.', phpIncludes = []) => {
+    const config = await loadConfig();
     const target = path.resolve(config?.kirigami?.root, file);
     const fsvm = path.join('/project', config?.kirigami?.root, file).replace(/\\/g, '/');
     await mountPath(target);
@@ -278,6 +289,7 @@ const render = async (file = '.', phpIncludes = []) => {
 
 
 const sitemap = async () => {
+    const config = await loadConfig();
     await mountPath(config?.kirigami?.root);
     return run(['sitemap']);
 }