pupt-lib 1.1.3 → 1.1.5

package/dist/api.d.ts

@@ -9,7 +9,7 @@ export interface DiscoveredPromptWithMethods {
     tags: string[];
     library: string;
     element: PuptElement;
-    render(options?: Partial<RenderOptions>): RenderResult;
+    render(options?: Partial<RenderOptions>): Promise<RenderResult>;
     getInputIterator(): InputIterator;
 }
 /**

package/dist/api.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"api.d.ts","sourceRoot":"","sources":["../src/api.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,cAAc,EACd,YAAY,EACZ,aAAa,EACb,aAAa,EACb,YAAY,EACZ,WAAW,EACZ,MAAM,SAAS,CAAC;AAGjB,OAAO,EAAuB,KAAK,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAGpF;;GAEG;AACH,MAAM,WAAW,2BAA2B;IAC1C,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,WAAW,CAAC;IACrB,MAAM,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC,aAAa,CAAC,GAAG,YAAY,CAAC;IACvD,gBAAgB,IAAI,aAAa,CAAC;CACnC;AAED;;GAEG;AACH,qBAAa,IAAI;IAMH,OAAO,CAAC,MAAM;IAL1B,OAAO,CAAC,YAAY,CAAsB;IAC1C,OAAO,CAAC,YAAY,CAAe;IACnC,OAAO,CAAC,OAAO,CAAqC;IACpD,OAAO,CAAC,WAAW,CAAS;gBAER,MAAM,EAAE,cAAc;IAIpC,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAmB3B,UAAU,CAAC,MAAM,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,EAAE,CAAA;KAAE,GAAG,2BAA2B,EAAE;IAOvE,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,2BAA2B,GAAG,SAAS;IAIhE,aAAa,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,CAAC,aAAa,CAAC,GAAG,YAAY,EAAE;IAI9E,OAAO,IAAI,MAAM,EAAE;IAInB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,2BAA2B,EAAE;YAI7C,eAAe;YAyCf,iBAAiB;IAe/B,OAAO,CAAC,eAAe;IAavB,OAAO,CAAC,sBAAsB;CA8B/B"}
+{"version":3,"file":"api.d.ts","sourceRoot":"","sources":["../src/api.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,cAAc,EACd,YAAY,EACZ,aAAa,EACb,aAAa,EACb,YAAY,EACZ,WAAW,EACZ,MAAM,SAAS,CAAC;AAGjB,OAAO,EAAuB,KAAK,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAGpF;;GAEG;AACH,MAAM,WAAW,2BAA2B;IAC1C,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,WAAW,CAAC;IACrB,MAAM,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC,aAAa,CAAC,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;IAChE,gBAAgB,IAAI,aAAa,CAAC;CACnC;AAED;;GAEG;AACH,qBAAa,IAAI;IAMH,OAAO,CAAC,MAAM;IAL1B,OAAO,CAAC,YAAY,CAAsB;IAC1C,OAAO,CAAC,YAAY,CAAe;IACnC,OAAO,CAAC,OAAO,CAAqC;IACpD,OAAO,CAAC,WAAW,CAAS;gBAER,MAAM,EAAE,cAAc;IAIpC,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAmB3B,UAAU,CAAC,MAAM,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,EAAE,CAAA;KAAE,GAAG,2BAA2B,EAAE;IAOvE,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,2BAA2B,GAAG,SAAS;IAIhE,aAAa,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,CAAC,aAAa,CAAC,GAAG,YAAY,EAAE;IAI9E,OAAO,IAAI,MAAM,EAAE;IAInB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,2BAA2B,EAAE;YAI7C,eAAe;YAyCf,iBAAiB;IAe/B,OAAO,CAAC,eAAe;IAavB,OAAO,CAAC,sBAAsB;CA8B/B"}

package/dist/component.d.ts

@@ -8,13 +8,26 @@ export declare const COMPONENT_MARKER: unique symbol;
  * Abstract base class for pupt-lib components.
  * Extend this class to create class-based components with access to render context.
  *
+ * Components can implement either synchronous or asynchronous render methods.
+ * Async render methods are useful for fetching data from APIs or performing
+ * other async operations.
+ *
  * @example
  * ```typescript
+ * // Synchronous render
  * class Greeting extends Component<{ name: string }> {
  *   render(props: { name: string }, context: RenderContext): string {
  *     return `Hello, ${props.name}!`;
  *   }
  * }
+ *
+ * // Asynchronous render
+ * class UserInfo extends Component<{ userId: string }> {
+ *   async render(props: { userId: string }, context: RenderContext): Promise<string> {
+ *     const user = await fetchUser(props.userId);
+ *     return `Name: ${user.name}`;
+ *   }
+ * }
  * ```
  */
 export declare abstract class Component<Props = Record<string, unknown>> {
@@ -26,9 +39,9 @@ export declare abstract class Component<Props = Record<string, unknown>> {
      *
      * @param props - The properties passed to the component
      * @param context - The render context containing environment and inputs
-     * @returns The rendered output as a PuptNode
+     * @returns The rendered output as a PuptNode, or a Promise resolving to a PuptNode for async components
      */
-    abstract render(props: Props, context: RenderContext): PuptNode;
+    abstract render(props: Props, context: RenderContext): PuptNode | Promise<PuptNode>;
 }
 /**
  * Type guard to check if a value is a Component class (not an instance).

package/dist/component.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"component.d.ts","sourceRoot":"","sources":["../src/component.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,KAAK,CAAC;AAClD,OAAO,KAAK,EAAE,QAAQ,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAEvD;;GAEG;AACH,eAAO,MAAM,gBAAgB,eAAsC,CAAC;AAEpE;;;;;;;;;;;;GAYG;AACH,8BAAsB,SAAS,CAAC,KAAK,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAC7D,MAAM,CAAC,CAAC,gBAAgB,CAAC,UAAQ;IAEjC,qEAAqE;IACrE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,WAAW,CAAC,CAAC;IAEtC;;;;;;OAMG;IACH,QAAQ,CAAC,MAAM,CAAC,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,aAAa,GAAG,QAAQ;CAChE;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,OAAO,GACb,KAAK,IAAI,OAAO,SAAS,CAK3B"}
+{"version":3,"file":"component.d.ts","sourceRoot":"","sources":["../src/component.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,KAAK,CAAC;AAClD,OAAO,KAAK,EAAE,QAAQ,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAEvD;;GAEG;AACH,eAAO,MAAM,gBAAgB,eAAsC,CAAC;AAEpE;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,8BAAsB,SAAS,CAAC,KAAK,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAC7D,MAAM,CAAC,CAAC,gBAAgB,CAAC,UAAQ;IAEjC,qEAAqE;IACrE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,WAAW,CAAC,CAAC;IAEtC;;;;;;OAMG;IACH,QAAQ,CAAC,MAAM,CAAC,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,aAAa,GAAG,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC;CACpF;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,OAAO,GACb,KAAK,IAAI,OAAO,SAAS,CAK3B"}

package/dist/index.js

@@ -1,7 +1,7 @@
 var __defProp = Object.defineProperty;
 var __defNormalProp = (obj, key, value) => key in obj ? __defProp(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
 var __publicField = (obj, key, value) => __defNormalProp(obj, typeof key !== "symbol" ? key + "" : key, value);
-var _a, _b;
+var _a, _b, _c, _d;
 import { z } from "zod";
 import { Fragment } from "./jsx-runtime/index.js";
 import MiniSearch from "minisearch";
@@ -210,7 +210,23 @@ function getComponentName(type) {
   }
   return "Unknown";
 }
-function render(element, options = {}) {
+const DEBUG_TIMING$1 = typeof process !== "undefined" && ((_b = process.env) == null ? void 0 : _b.CI) === "true";
+const SLOW_THRESHOLD_MS$1 = 1e3;
+let renderCallCount = 0;
+async function render(element, options = {}) {
+  const callNum = ++renderCallCount;
+  const start = Date.now();
+  let lastCheckpoint = start;
+  const logSlow = (step) => {
+    if (!DEBUG_TIMING$1) return;
+    const now = Date.now();
+    const stepTime = now - lastCheckpoint;
+    const totalTime = now - start;
+    if (stepTime >= SLOW_THRESHOLD_MS$1) {
+      console.log(`[SLOW RENDER #${callNum}] ${step} took ${stepTime}ms (total: ${totalTime}ms)`);
+    }
+    lastCheckpoint = now;
+  };
   const {
     inputs = /* @__PURE__ */ new Map(),
     env = DEFAULT_ENVIRONMENT,
@@ -224,7 +240,9 @@ function render(element, options = {}) {
     postExecution,
     errors
   };
-  const text = renderNode(element, context);
+  logSlow("context setup");
+  const text = await renderNode(element, context);
+  logSlow("renderNode");
   const trimmedText = trim ? text.trim() : text;
   if (errors.length > 0) {
     return {
@@ -240,7 +258,7 @@ function render(element, options = {}) {
     postExecution
   };
 }
-function renderNode(node, context) {
+async function renderNode(node, context) {
   if (node === null || node === void 0 || node === false) {
     return "";
   }
@@ -248,14 +266,16 @@ function renderNode(node, context) {
     return String(node);
   }
   if (Array.isArray(node)) {
-    return node.map((n) => renderNode(n, context)).join("");
+    const results = await Promise.all(node.map((n) => renderNode(n, context)));
+    return results.join("");
   }
   return renderElement(node, context);
 }
-function renderChildrenFallback(children, context) {
-  return children.map((c) => renderNode(c, context)).join("");
+async function renderChildrenFallback(children, context) {
+  const results = await Promise.all(children.map((c) => renderNode(c, context)));
+  return results.join("");
 }
-function renderComponentWithValidation(type, componentName, props, children, context, renderFn) {
+async function renderComponentWithValidation(type, componentName, props, children, context, renderFn) {
   const schema = getSchema(type);
   if (!schema) {
     context.errors.push({
@@ -274,7 +294,8 @@ function renderComponentWithValidation(type, componentName, props, children, con
   }
   try {
     const result = renderFn();
-    return renderNode(result, context);
+    const resolvedResult = result instanceof Promise ? await result : result;
+    return renderNode(resolvedResult, context);
   } catch (err) {
     const message = err instanceof Error ? err.message : String(err);
     context.errors.push({
@@ -287,10 +308,11 @@ function renderComponentWithValidation(type, componentName, props, children, con
     return renderChildrenFallback(children, context);
   }
 }
-function renderElement(element, context) {
+async function renderElement(element, context) {
   const { type, props, children } = element;
   if (type === Fragment) {
-    return children.map((c) => renderNode(c, context)).join("");
+    const results = await Promise.all(children.map((c) => renderNode(c, context)));
+    return results.join("");
   }
   if (isComponentClass(type)) {
     return renderComponentWithValidation(
@@ -320,10 +342,14 @@ function renderElement(element, context) {
   }
   if (typeof type === "string") {
     console.warn(`Unknown component type "${type}". Components should be imported, not referenced by string.`);
-    return children.map((c) => renderNode(c, context)).join("");
+    const results = await Promise.all(children.map((c) => renderNode(c, context)));
+    return results.join("");
   }
   return "";
 }
+const DEBUG_TIMING = typeof process !== "undefined" && ((_c = process.env) == null ? void 0 : _c.CI) === "true";
+const SLOW_THRESHOLD_MS = 1e3;
+let iteratorCallCount = 0;
 function detectEnvironment() {
   var _a2;
   if (typeof process !== "undefined" && ((_a2 = process.versions) == null ? void 0 : _a2.node)) {
@@ -366,7 +392,7 @@ function createInputIterator(element, options = {}) {
     values2.set(key, value);
   }
   async function processNonInteractively() {
-    const allReqs = collectRequirements(element);
+    const allReqs = await collectRequirements(element);
     for (const req of allReqs) {
       if (values2.has(req.name)) {
         continue;
@@ -396,8 +422,9 @@ function createInputIterator(element, options = {}) {
       values2.set(req.name, valueToUse);
     }
   }
-  function collectRequirements(node) {
+  async function collectRequirements(node) {
     const collected = [];
+    const configStart = Date.now();
     const context = {
       inputs: values2,
       env: { ...DEFAULT_ENVIRONMENT, runtime: createRuntimeConfig() },
@@ -405,7 +432,14 @@ function createInputIterator(element, options = {}) {
       errors: [],
       __requirements: collected
     };
-    walkNode(node, context);
+    if (DEBUG_TIMING && Date.now() - configStart >= SLOW_THRESHOLD_MS) {
+      console.log(`[SLOW] createRuntimeConfig took ${Date.now() - configStart}ms`);
+    }
+    const walkStart = Date.now();
+    await walkNode(node, context);
+    if (DEBUG_TIMING && Date.now() - walkStart >= SLOW_THRESHOLD_MS) {
+      console.log(`[SLOW] walkNode took ${Date.now() - walkStart}ms`);
+    }
     return collected;
   }
   function findNextUnfilledIndex(reqs, startIndex) {
@@ -416,7 +450,7 @@ function createInputIterator(element, options = {}) {
     }
     return reqs.length;
   }
-  function walkNode(node, context) {
+  async function walkNode(node, context) {
     if (node === null || node === void 0 || node === false) {
       return;
     }
@@ -425,7 +459,7 @@ function createInputIterator(element, options = {}) {
     }
     if (Array.isArray(node)) {
       for (const child of node) {
-        walkNode(child, context);
+        await walkNode(child, context);
       }
       return;
     }
@@ -433,29 +467,31 @@ function createInputIterator(element, options = {}) {
     const { type, props, children } = element2;
     if (type === Fragment) {
       for (const child of children) {
-        walkNode(child, context);
+        await walkNode(child, context);
       }
       return;
     }
     if (isComponentClass(type)) {
       const instance = new type();
-      const result = instance.render({ ...props, children }, context);
+      const renderResult = instance.render({ ...props, children }, context);
+      const result = renderResult instanceof Promise ? await renderResult : renderResult;
       if (result !== null && typeof result === "object") {
-        walkNode(result, context);
+        await walkNode(result, context);
       }
       return;
     }
     if (typeof type === "function" && !isComponentClass(type)) {
       const fn = type;
-      const result = fn({ ...props, children });
+      const renderResult = fn({ ...props, children });
+      const result = renderResult instanceof Promise ? await renderResult : renderResult;
       if (result !== null && typeof result === "object") {
-        walkNode(result, context);
+        await walkNode(result, context);
       }
       return;
     }
     if (typeof type === "string") {
       for (const child of children) {
-        walkNode(child, context);
+        await walkNode(child, context);
       }
     }
   }
@@ -754,7 +790,15 @@ function createInputIterator(element, options = {}) {
     };
   }
   return {
-    start() {
+    async start() {
+      const callNum = ++iteratorCallCount;
+      const logSlow = (step, stepStart) => {
+        if (!DEBUG_TIMING) return;
+        const stepTime = Date.now() - stepStart;
+        if (stepTime >= SLOW_THRESHOLD_MS) {
+          console.log(`[SLOW ITERATOR #${callNum}] ${step} took ${stepTime}ms`);
+        }
+      };
       if (state !== "NOT_STARTED") {
         throw new Error("Iterator already started.");
       }
@@ -762,7 +806,9 @@ function createInputIterator(element, options = {}) {
         state = "DONE";
         return;
       }
-      requirements = collectRequirements(element);
+      const collectStart = Date.now();
+      requirements = await collectRequirements(element);
+      logSlow("collectRequirements", collectStart);
       currentIndex = findNextUnfilledIndex(requirements, 0);
       state = currentIndex < requirements.length ? "ITERATING" : "DONE";
     },
@@ -797,7 +843,7 @@ function createInputIterator(element, options = {}) {
         warnings: []
       };
     },
-    advance() {
+    async advance() {
       if (state === "NOT_STARTED") {
         throw new Error("Iterator not started. Call start() first.");
       }
@@ -807,7 +853,7 @@ function createInputIterator(element, options = {}) {
       if (state === "DONE") {
         throw new Error("Iterator is done. Nothing to advance.");
       }
-      requirements = collectRequirements(element);
+      requirements = await collectRequirements(element);
       currentIndex = findNextUnfilledIndex(requirements, currentIndex + 1);
       state = currentIndex < requirements.length ? "ITERATING" : "DONE";
     },
@@ -15666,8 +15712,8 @@ const movedSimpleCellAddress = (address, toSheet, toRight, toBottom) => {
 };
 const addressKey = (address) => `${address.sheet},${address.row},${address.col}`;
 function isSimpleCellAddress(obj) {
-  var _a2, _b2, _c;
-  return obj && (typeof obj === "object" || typeof obj === "function") && typeof ((_a2 = obj) === null || _a2 === void 0 ? void 0 : _a2.sheet) === "number" && typeof ((_b2 = obj) === null || _b2 === void 0 ? void 0 : _b2.col) === "number" && typeof ((_c = obj) === null || _c === void 0 ? void 0 : _c.row) === "number";
+  var _a2, _b2, _c2;
+  return obj && (typeof obj === "object" || typeof obj === "function") && typeof ((_a2 = obj) === null || _a2 === void 0 ? void 0 : _a2.sheet) === "number" && typeof ((_b2 = obj) === null || _b2 === void 0 ? void 0 : _b2.col) === "number" && typeof ((_c2 = obj) === null || _c2 === void 0 ? void 0 : _c2.row) === "number";
 }
 const absoluteSheetReference = (address, baseAddress) => {
   var _a2;
@@ -17397,7 +17443,7 @@ function defaultParseToDateTime(text, dateFormat, timeFormat) {
   }
 }
 function defaultParseToTime(timeItems, timeFormat) {
-  var _a2, _b2, _c;
+  var _a2, _b2, _c2;
   if (timeFormat === void 0) {
     return void 0;
   }
@@ -17427,7 +17473,7 @@ function defaultParseToTime(timeItems, timeFormat) {
   if (!(Number.isFinite(minutes) && Number.isInteger(minutes))) {
     return void 0;
   }
-  const hoursParsed = Number((_c = timeItems[hourItem]) !== null && _c !== void 0 ? _c : "0");
+  const hoursParsed = Number((_c2 = timeItems[hourItem]) !== null && _c2 !== void 0 ? _c2 : "0");
   if (!(Number.isFinite(hoursParsed) && Number.isInteger(hoursParsed))) {
     return void 0;
   }
@@ -21887,9 +21933,9 @@ const buildCriterion = (operator, value) => ({
 });
 class CriterionBuilder {
   constructor(config) {
-    var _a2, _b2, _c, _d;
+    var _a2, _b2, _c2, _d2;
     this.trueString = (_b2 = (_a2 = config.translationPackage.getMaybeFunctionTranslation("TRUE")) === null || _a2 === void 0 ? void 0 : _a2.toLowerCase()) !== null && _b2 !== void 0 ? _b2 : "true";
-    this.falseString = (_d = (_c = config.translationPackage.getMaybeFunctionTranslation("FALSE")) === null || _c === void 0 ? void 0 : _c.toLowerCase()) !== null && _d !== void 0 ? _d : "false";
+    this.falseString = (_d2 = (_c2 = config.translationPackage.getMaybeFunctionTranslation("FALSE")) === null || _c2 === void 0 ? void 0 : _c2.toLowerCase()) !== null && _d2 !== void 0 ? _d2 : "false";
   }
   fromCellValue(raw, arithmeticHelper) {
     if (typeof raw !== "string" && typeof raw !== "boolean" && typeof raw !== "number") {
@@ -30945,14 +30991,14 @@ class InformationPlugin extends FunctionPlugin {
    */
   index(ast, state) {
     return this.runFunction(ast.args, state, this.metadata("INDEX"), (rangeValue, row, col) => {
-      var _a2, _b2, _c, _d, _e, _f;
+      var _a2, _b2, _c2, _d2, _e, _f;
       if (col < 1 || row < 1) {
         return new CellError(ErrorType.VALUE, ErrorMessage.LessThanOne);
       }
       if (col > rangeValue.width() || row > rangeValue.height()) {
         return new CellError(ErrorType.NUM, ErrorMessage.ValueLarge);
       }
-      return (_f = (_c = (_b2 = (_a2 = rangeValue === null || rangeValue === void 0 ? void 0 : rangeValue.data) === null || _a2 === void 0 ? void 0 : _a2[row - 1]) === null || _b2 === void 0 ? void 0 : _b2[col - 1]) !== null && _c !== void 0 ? _c : (_e = (_d = rangeValue === null || rangeValue === void 0 ? void 0 : rangeValue.data) === null || _d === void 0 ? void 0 : _d[0]) === null || _e === void 0 ? void 0 : _e[0]) !== null && _f !== void 0 ? _f : new CellError(ErrorType.VALUE, ErrorMessage.CellRangeExpected);
+      return (_f = (_c2 = (_b2 = (_a2 = rangeValue === null || rangeValue === void 0 ? void 0 : rangeValue.data) === null || _a2 === void 0 ? void 0 : _a2[row - 1]) === null || _b2 === void 0 ? void 0 : _b2[col - 1]) !== null && _c2 !== void 0 ? _c2 : (_e = (_d2 = rangeValue === null || rangeValue === void 0 ? void 0 : rangeValue.data) === null || _d2 === void 0 ? void 0 : _d2[0]) === null || _e === void 0 ? void 0 : _e[0]) !== null && _f !== void 0 ? _f : new CellError(ErrorType.VALUE, ErrorMessage.CellRangeExpected);
     });
   }
   /**
@@ -38429,7 +38475,7 @@ ${result}`;
   }
   return result;
 }
-const isNode = typeof process !== "undefined" && ((_b = process.versions) == null ? void 0 : _b.node);
+const isNode = typeof process !== "undefined" && ((_d = process.versions) == null ? void 0 : _d.node);
 async function resolveLocalPath(source) {
   if (!isNode) {
     return source;
@@ -38715,12 +38761,14 @@ ${json}
 <\/script>`;
 }
 const DEFAULT_ZOD_VERSION = "3.24.2";
+const DEFAULT_MINISEARCH_VERSION = "7.2.0";
 function generatePuptLibImportMap(options = {}) {
   const {
     cdn = "esm.sh",
     cdnTemplate,
     puptLibVersion = "latest",
     zodVersion = DEFAULT_ZOD_VERSION,
+    minisearchVersion = DEFAULT_MINISEARCH_VERSION,
     additionalDependencies = []
   } = options;
   const cdnOptions = cdnTemplate ? { cdnTemplate } : { cdn };
@@ -38729,6 +38777,7 @@ function generatePuptLibImportMap(options = {}) {
   imports["pupt-lib"] = puptLibUrl;
   imports["pupt-lib/jsx-runtime"] = `${puptLibUrl}/jsx-runtime`;
   imports["zod"] = resolveCdn("zod", zodVersion, cdnOptions);
+  imports["minisearch"] = resolveCdn("minisearch", minisearchVersion, cdnOptions);
   for (const dep of additionalDependencies) {
     imports[dep.name] = resolveCdn(dep.name, dep.version, cdnOptions);
   }
@@ -40194,7 +40243,7 @@ class Pupt {
       tags,
       library,
       element,
-      render: (options) => {
+      render: async (options) => {
         const inputsObj = (options == null ? void 0 : options.inputs) ?? {};
         const inputsMap = inputsObj instanceof Map ? inputsObj : new Map(Object.entries(inputsObj));
         return render(element, {

package/dist/render.d.ts

@@ -1,3 +1,19 @@
 import { PuptElement, RenderResult, RenderOptions } from './types';
-export declare function render(element: PuptElement, options?: RenderOptions): RenderResult;
+/**
+ * Render a PuptElement tree to a string.
+ *
+ * This function is async to support components with async render methods.
+ * Components can perform async operations like API calls in their render methods.
+ *
+ * @param element - The root PuptElement to render
+ * @param options - Render options including inputs and environment
+ * @returns A Promise resolving to the RenderResult
+ *
+ * @example
+ * ```typescript
+ * const result = await render(<MyPrompt />);
+ * console.log(result.text);
+ * ```
+ */
+export declare function render(element: PuptElement, options?: RenderOptions): Promise<RenderResult>;
 //# sourceMappingURL=render.d.ts.map

package/dist/render.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"render.d.ts","sourceRoot":"","sources":["../src/render.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAY,YAAY,EAAE,aAAa,EAAmD,MAAM,SAAS,CAAC;AASnI,wBAAgB,MAAM,CACpB,OAAO,EAAE,WAAW,EACpB,OAAO,GAAE,aAAkB,GAC1B,YAAY,CAkCd"}
+{"version":3,"file":"render.d.ts","sourceRoot":"","sources":["../src/render.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAY,YAAY,EAAE,aAAa,EAAmD,MAAM,SAAS,CAAC;AAcnI;;;;;;;;;;;;;;;GAeG;AACH,wBAAsB,MAAM,CAC1B,OAAO,EAAE,WAAW,EACpB,OAAO,GAAE,aAAkB,GAC1B,OAAO,CAAC,YAAY,CAAC,CAmDvB"}

package/dist/services/browser-support.d.ts

@@ -120,6 +120,8 @@ export interface PuptLibImportMapOptions {
     puptLibVersion?: string;
     /** zod version (default: '3.24.2') */
     zodVersion?: string;
+    /** minisearch version (default: '7.2.0') */
+    minisearchVersion?: string;
     /** Additional dependencies to include */
     additionalDependencies?: Dependency[];
 }
@@ -131,6 +133,7 @@ export interface PuptLibImportMapOptions {
  * - pupt-lib main entry
  * - pupt-lib/jsx-runtime subpath
  * - zod (required peer dependency)
+ * - minisearch (required for search functionality)
  *
  * @param options - Configuration options
  * @returns An ImportMap object ready to be serialized
@@ -163,7 +166,8 @@ export interface PuptLibImportMapOptions {
  *     "imports": {
  *       "pupt-lib": "https://esm.sh/pupt-lib@1.1.0",
  *       "pupt-lib/jsx-runtime": "https://esm.sh/pupt-lib@1.1.0/jsx-runtime",
- *       "zod": "https://esm.sh/zod@3.24.2"
+ *       "zod": "https://esm.sh/zod@3.24.2",
+ *       "minisearch": "https://esm.sh/minisearch@7.2.0"
  *     }
  *   }
  * </script>

package/dist/services/browser-support.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"browser-support.d.ts","sourceRoot":"","sources":["../../src/services/browser-support.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;GAEG;AACH,MAAM,MAAM,WAAW,GAAG,QAAQ,GAAG,OAAO,GAAG,UAAU,GAAG,SAAS,CAAC;AAYtE;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,0BAA0B;IAC1B,GAAG,CAAC,EAAE,WAAW,CAAC;IAClB,qFAAqF;IACrF,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,+DAA+D;IAC/D,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,qCAAqC;IACrC,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;CACjD;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;;GAGG;AACH,MAAM,WAAW,SAAS;IACxB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;CACjD;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,UAAU,CACxB,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,UAAU,GAClB,MAAM,CAsBR;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,iBAAiB,CAC/B,YAAY,EAAE,UAAU,EAAE,EAC1B,OAAO,EAAE,UAAU,GAClB,SAAS,CAeX;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,kBAAkB,CAAC,SAAS,EAAE,SAAS,GAAG,MAAM,CAE/D;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,uBAAuB,CACrC,YAAY,EAAE,UAAU,EAAE,EAC1B,OAAO,EAAE,UAAU,GAClB,MAAM,CAIR;AAED;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC,8CAA8C;IAC9C,GAAG,CAAC,EAAE,WAAW,CAAC;IAClB,8BAA8B;IAC9B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,4DAA4D;IAC5D,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,sCAAsC;IACtC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,yCAAyC;IACzC,sBAAsB,CAAC,EAAE,UAAU,EAAE,CAAC;CACvC;AAQD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6CG;AACH,wBAAgB,wBAAwB,CACtC,OAAO,GAAE,uBAA4B,GACpC,SAAS,CA+BX;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,8BAA8B,CAC5C,OAAO,GAAE,uBAA4B,GACpC,MAAM,CAIR"}
+{"version":3,"file":"browser-support.d.ts","sourceRoot":"","sources":["../../src/services/browser-support.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;GAEG;AACH,MAAM,MAAM,WAAW,GAAG,QAAQ,GAAG,OAAO,GAAG,UAAU,GAAG,SAAS,CAAC;AAYtE;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,0BAA0B;IAC1B,GAAG,CAAC,EAAE,WAAW,CAAC;IAClB,qFAAqF;IACrF,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,+DAA+D;IAC/D,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,qCAAqC;IACrC,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;CACjD;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;;GAGG;AACH,MAAM,WAAW,SAAS;IACxB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;CACjD;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,UAAU,CACxB,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,UAAU,GAClB,MAAM,CAsBR;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,iBAAiB,CAC/B,YAAY,EAAE,UAAU,EAAE,EAC1B,OAAO,EAAE,UAAU,GAClB,SAAS,CAeX;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,kBAAkB,CAAC,SAAS,EAAE,SAAS,GAAG,MAAM,CAE/D;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,uBAAuB,CACrC,YAAY,EAAE,UAAU,EAAE,EAC1B,OAAO,EAAE,UAAU,GAClB,MAAM,CAIR;AAED;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC,8CAA8C;IAC9C,GAAG,CAAC,EAAE,WAAW,CAAC;IAClB,8BAA8B;IAC9B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,4DAA4D;IAC5D,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,sCAAsC;IACtC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,4CAA4C;IAC5C,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,yCAAyC;IACzC,sBAAsB,CAAC,EAAE,UAAU,EAAE,CAAC;CACvC;AAcD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+CG;AACH,wBAAgB,wBAAwB,CACtC,OAAO,GAAE,uBAA4B,GACpC,SAAS,CAmCX;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,8BAA8B,CAC5C,OAAO,GAAE,uBAA4B,GACpC,MAAM,CAIR"}

package/dist/services/input-iterator.d.ts

@@ -27,10 +27,18 @@ export interface InputIteratorOptions {
     onMissingDefault?: OnMissingDefaultStrategy;
 }
 export interface InputIterator {
-    start(): void;
+    /**
+     * Start the iterator by collecting input requirements from the element tree.
+     * This is async to support components with async render methods.
+     */
+    start(): Promise<void>;
     current(): InputRequirement | null;
     submit(value: unknown): Promise<ValidationResult>;
-    advance(): void;
+    /**
+     * Advance to the next unfilled requirement.
+     * This is async to support re-collecting requirements from async components.
+     */
+    advance(): Promise<void>;
     isDone(): boolean;
     getValues(): Map<string, unknown>;
     /**

package/dist/services/input-iterator.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"input-iterator.d.ts","sourceRoot":"","sources":["../../src/services/input-iterator.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAY,gBAAgB,EAAE,gBAAgB,EAAiB,MAAM,UAAU,CAAC;AAOzG,MAAM,MAAM,kBAAkB,GAAG,MAAM,GAAG,SAAS,CAAC;AA6CpD;;GAEG;AACH,MAAM,MAAM,wBAAwB,GAAG,OAAO,GAAG,MAAM,CAAC;AAExD,MAAM,WAAW,oBAAoB;IACnC,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,0DAA0D;IAC1D,WAAW,CAAC,EAAE,kBAAkB,CAAC;IACjC;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjC;;;;OAIG;IACH,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB;;;;OAIG;IACH,gBAAgB,CAAC,EAAE,wBAAwB,CAAC;CAC7C;AAED,MAAM,WAAW,aAAa;IAC5B,KAAK,IAAI,IAAI,CAAC;IACd,OAAO,IAAI,gBAAgB,GAAG,IAAI,CAAC;IACnC,MAAM,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAAC;IAClD,OAAO,IAAI,IAAI,CAAC;IAChB,MAAM,IAAI,OAAO,CAAC;IAClB,SAAS,IAAI,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAClC;;;;;;OAMG;IACH,iBAAiB,IAAI,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;CACpD;AAID,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,WAAW,EACpB,OAAO,GAAE,oBAAyB,GACjC,aAAa,CAqlBf"}
+{"version":3,"file":"input-iterator.d.ts","sourceRoot":"","sources":["../../src/services/input-iterator.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAY,gBAAgB,EAAE,gBAAgB,EAAiB,MAAM,UAAU,CAAC;AAYzG,MAAM,MAAM,kBAAkB,GAAG,MAAM,GAAG,SAAS,CAAC;AA6CpD;;GAEG;AACH,MAAM,MAAM,wBAAwB,GAAG,OAAO,GAAG,MAAM,CAAC;AAExD,MAAM,WAAW,oBAAoB;IACnC,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,0DAA0D;IAC1D,WAAW,CAAC,EAAE,kBAAkB,CAAC;IACjC;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjC;;;;OAIG;IACH,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB;;;;OAIG;IACH,gBAAgB,CAAC,EAAE,wBAAwB,CAAC;CAC7C;AAED,MAAM,WAAW,aAAa;IAC5B;;;OAGG;IACH,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACvB,OAAO,IAAI,gBAAgB,GAAG,IAAI,CAAC;IACnC,MAAM,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAAC;IAClD;;;OAGG;IACH,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACzB,MAAM,IAAI,OAAO,CAAC;IAClB,SAAS,IAAI,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAClC;;;;;;OAMG;IACH,iBAAiB,IAAI,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;CACpD;AAID,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,WAAW,EACpB,OAAO,GAAE,oBAAyB,GACjC,aAAa,CA6mBf"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pupt-lib",
-  "version": "1.1.3",
+  "version": "1.1.5",
   "description": "TypeScript library for creating AI prompts using JSX syntax",
   "license": "MIT",
   "author": "",