@kinotic-ai/spawn 0.1.1 → 0.3.0

package/dist/index.cjs

@@ -69,7 +69,7 @@ function camelCase(s) {
 class SpawnEngine {
   engine;
   constructor() {
-    this.engine = new import_liquidjs.Liquid({ cache: true });
+    this.engine = new import_liquidjs.Liquid({ cache: true, strictVariables: true });
     this.engine.registerFilter("packageToPath", (v) => v.replaceAll(".", "/"));
     this.engine.registerFilter("encodePackage", (v) => {
       v = v.replaceAll("-", "_");
@@ -110,6 +110,7 @@ class SpawnEngine {
     let context = { ...globals, ...options?.context };
     context = await this.resolveMissingProperties(propertySchemas, context, options?.propertyResolver);
     const files = {};
+    const sources = {};
     for (const tree of [...trees].reverse()) {
       for (const source of Object.keys(tree).sort()) {
         const fileName = source.substring(source.lastIndexOf("/") + 1);
@@ -129,9 +130,10 @@ class SpawnEngine {
           content = await this.engine.parseAndRender(content, context);
         }
         files[destination] = content;
+        sources[destination] = source;
       }
     }
-    return { files, context };
+    return { files, sources, context };
   }
   parseConfig(tree) {
     const raw = tree["spawn.json"];

package/dist/index.d.cts

@@ -71,6 +71,13 @@ interface SpawnRenderResult {
 	*/
 	files: SpawnTree;
 	/**
+	* The originating spawn path for each rendered file, keyed by the same
+	* destination path used in {@link files}. Lets a host trace a rendered file
+	* back to its template entry to recover source metadata (e.g. the executable
+	* bit) that the destination path alone cannot convey.
+	*/
+	sources: Record<string, string>;
+	/**
 	* The full context the templates were rendered with: merged globals,
 	* caller-provided values, and any values supplied by the property resolver.
 	*/
@@ -93,6 +100,8 @@ interface SpawnRenderResult {
 *   {@link PropertyResolver}, or fail the render when no resolver is given
 * - paths containing liquid expressions are rendered; files ending in
 *   {@code .liquid} have their content rendered and the suffix stripped
+* - a reference to a variable that is neither in the context nor declared in
+*   spawn.json throws rather than rendering empty (strictVariables)
 * - files from derived spawns overwrite same-destination files from inherited
 *   spawns
 */

package/dist/index.d.ts

@@ -71,6 +71,13 @@ interface SpawnRenderResult {
 	*/
 	files: SpawnTree;
 	/**
+	* The originating spawn path for each rendered file, keyed by the same
+	* destination path used in {@link files}. Lets a host trace a rendered file
+	* back to its template entry to recover source metadata (e.g. the executable
+	* bit) that the destination path alone cannot convey.
+	*/
+	sources: Record<string, string>;
+	/**
 	* The full context the templates were rendered with: merged globals,
 	* caller-provided values, and any values supplied by the property resolver.
 	*/
@@ -93,6 +100,8 @@ interface SpawnRenderResult {
 *   {@link PropertyResolver}, or fail the render when no resolver is given
 * - paths containing liquid expressions are rendered; files ending in
 *   {@code .liquid} have their content rendered and the suffix stripped
+* - a reference to a variable that is neither in the context nor declared in
+*   spawn.json throws rather than rendering empty (strictVariables)
 * - files from derived spawns overwrite same-destination files from inherited
 *   spawns
 */

package/dist/index.js

@@ -23,7 +23,7 @@ function camelCase(s) {
 class SpawnEngine {
   engine;
   constructor() {
-    this.engine = new Liquid({ cache: true });
+    this.engine = new Liquid({ cache: true, strictVariables: true });
     this.engine.registerFilter("packageToPath", (v) => v.replaceAll(".", "/"));
     this.engine.registerFilter("encodePackage", (v) => {
       v = v.replaceAll("-", "_");
@@ -64,6 +64,7 @@ class SpawnEngine {
     let context = { ...globals, ...options?.context };
     context = await this.resolveMissingProperties(propertySchemas, context, options?.propertyResolver);
     const files = {};
+    const sources = {};
     for (const tree of [...trees].reverse()) {
       for (const source of Object.keys(tree).sort()) {
         const fileName = source.substring(source.lastIndexOf("/") + 1);
@@ -83,9 +84,10 @@ class SpawnEngine {
           content = await this.engine.parseAndRender(content, context);
         }
         files[destination] = content;
+        sources[destination] = source;
       }
     }
-    return { files, context };
+    return { files, sources, context };
   }
   parseConfig(tree) {
     const raw = tree["spawn.json"];

package/dist/spawn-renderer.global.js

@@ -19003,7 +19003,7 @@ From ` + this.originalError.stack;
   class SpawnEngine {
     engine;
     constructor() {
-      this.engine = new Liquid({ cache: true });
+      this.engine = new Liquid({ cache: true, strictVariables: true });
       this.engine.registerFilter("packageToPath", (v) => v.replaceAll(".", "/"));
       this.engine.registerFilter("encodePackage", (v) => {
         v = v.replaceAll("-", "_");
@@ -19044,6 +19044,7 @@ From ` + this.originalError.stack;
       let context = { ...globals, ...options?.context };
       context = await this.resolveMissingProperties(propertySchemas, context, options?.propertyResolver);
       const files = {};
+      const sources = {};
       for (const tree of [...trees].reverse()) {
         for (const source of Object.keys(tree).sort()) {
           const fileName = source.substring(source.lastIndexOf("/") + 1);
@@ -19063,9 +19064,10 @@ From ` + this.originalError.stack;
             content = await this.engine.parseAndRender(content, context);
           }
           files[destination] = content;
+          sources[destination] = source;
         }
       }
-      return { files, context };
+      return { files, sources, context };
     }
     parseConfig(tree) {
       const raw2 = tree["spawn.json"];
@@ -19104,7 +19106,7 @@ From ` + this.originalError.stack;
   var engine = new SpawnEngine;
   function renderSpawn(inputJson) {
     const input = JSON.parse(inputJson);
-    return engine.renderSpawn(input.files, { context: input.context }).then((result) => JSON.stringify(result.files));
+    return engine.renderSpawn(input.files, { context: input.context }).then((result) => JSON.stringify({ files: result.files, sources: result.sources }));
   }
   globalThis["KinoticSpawn"] = { renderSpawn };
 })();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kinotic-ai/spawn",
-  "version": "0.1.1",
+  "version": "0.3.0",
   "type": "module",
   "files": [
     "dist"