@pupt/react 0.0.1 → 1.2.0

package/dist/index.cjs

@@ -0,0 +1,1092 @@
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const jsxRuntime = require("react/jsx-runtime");
+const react = require("react");
+const lib = require("@pupt/lib");
+function usePuptLibrary(options = {}) {
+  const { modules: initialModules = [], searchConfig } = options;
+  const [modules, setModules] = react.useState(initialModules);
+  const [isLoading, setIsLoading] = react.useState(false);
+  const [error, setError] = react.useState(null);
+  const [prompts, setPrompts] = react.useState([]);
+  const [tags, setTags] = react.useState([]);
+  const puptRef = react.useRef(null);
+  const searchConfigRef = react.useRef(searchConfig);
+  searchConfigRef.current = searchConfig;
+  react.useEffect(() => {
+    let cancelled = false;
+    async function init() {
+      setIsLoading(true);
+      setError(null);
+      try {
+        const config = { modules };
+        if (searchConfigRef.current) {
+          config.searchConfig = searchConfigRef.current;
+        }
+        const pupt = new lib.Pupt(config);
+        await pupt.init();
+        if (cancelled) {
+          return;
+        }
+        puptRef.current = pupt;
+        setPrompts(pupt.getPrompts());
+        setTags(pupt.getTags());
+      } catch (err) {
+        if (cancelled) {
+          return;
+        }
+        setError(err instanceof Error ? err : new Error(String(err)));
+        setPrompts([]);
+        setTags([]);
+      } finally {
+        if (!cancelled) {
+          setIsLoading(false);
+        }
+      }
+    }
+    void init();
+    return () => {
+      cancelled = true;
+    };
+  }, [modules]);
+  const getPrompt = react.useCallback(
+    (name) => {
+      var _a;
+      return (_a = puptRef.current) == null ? void 0 : _a.getPrompt(name);
+    },
+    [prompts]
+  );
+  const getPromptsByTag = react.useCallback(
+    (tag) => {
+      var _a;
+      return ((_a = puptRef.current) == null ? void 0 : _a.getPromptsByTag(tag)) ?? [];
+    },
+    [prompts]
+  );
+  const addModule = react.useCallback((source) => {
+    setModules((prev) => {
+      if (prev.includes(source)) {
+        return prev;
+      }
+      return [...prev, source];
+    });
+  }, []);
+  const removeModule = react.useCallback((source) => {
+    setModules((prev) => prev.filter((m) => m !== source));
+  }, []);
+  return {
+    isLoading,
+    error,
+    prompts,
+    tags,
+    getPrompt,
+    getPromptsByTag,
+    addModule,
+    removeModule,
+    modules
+  };
+}
+const PuptLibraryContext = react.createContext(null);
+PuptLibraryContext.displayName = "PuptLibraryContext";
+function PuptLibraryProvider({ children, modules, searchConfig }) {
+  const opts = {};
+  if (modules) {
+    opts.modules = modules;
+  }
+  if (searchConfig) {
+    opts.searchConfig = searchConfig;
+  }
+  const library = usePuptLibrary(opts);
+  const value = react.useMemo(
+    () => library,
+    [library.isLoading, library.error, library.prompts, library.tags, library.modules]
+  );
+  return /* @__PURE__ */ jsxRuntime.jsx(PuptLibraryContext.Provider, { value, children });
+}
+const defaultContextValue = {
+  _initialized: false,
+  searchEngine: null,
+  prompts: [],
+  renderOptions: {},
+  environment: {},
+  isLoading: false,
+  error: null
+};
+const PuptContext = react.createContext(defaultContextValue);
+PuptContext.displayName = "PuptContext";
+async function transformSource(source, options = {}) {
+  const { filename = "prompt.tsx" } = options;
+  return lib.createPromptFromSource(source, filename);
+}
+async function extractInputRequirements(element, options) {
+  try {
+    const iteratorOpts = {
+      validateOnSubmit: false,
+      environment: "browser"
+    };
+    if (options == null ? void 0 : options.values) {
+      iteratorOpts.values = options.values;
+    }
+    const iterator = lib.createInputIterator(element, iteratorOpts);
+    const requirements = [];
+    await iterator.start();
+    while (!iterator.isDone()) {
+      const current = iterator.current();
+      if (current) {
+        requirements.push(current);
+        await iterator.submit(void 0);
+      }
+      await iterator.advance();
+    }
+    return requirements;
+  } catch {
+    return [];
+  }
+}
+function isAskComponent(type) {
+  if (typeof type === "string") {
+    return type.startsWith("Ask.") || type === "Ask";
+  }
+  return false;
+}
+function traverseElement(element, visitor) {
+  visitor(element);
+  const children = element[lib.CHILDREN];
+  if (children) {
+    if (Array.isArray(children)) {
+      for (const child of children) {
+        if (isElement(child)) {
+          traverseElement(child, visitor);
+        }
+      }
+    } else if (isElement(children)) {
+      traverseElement(children, visitor);
+    }
+  }
+}
+function isElement(value) {
+  return lib.isPuptElement(value);
+}
+function validateInput(requirement, value) {
+  const errors = [];
+  switch (requirement.type) {
+    case "number":
+      if (typeof value !== "number" || isNaN(value)) {
+        errors.push({
+          field: requirement.name,
+          message: `Expected a number, got ${typeof value}`,
+          code: "INVALID_TYPE"
+        });
+      } else {
+        if (requirement.min !== void 0 && value < requirement.min) {
+          errors.push({
+            field: requirement.name,
+            message: `Value ${value} is below minimum ${requirement.min}`,
+            code: "BELOW_MIN"
+          });
+        }
+        if (requirement.max !== void 0 && value > requirement.max) {
+          errors.push({
+            field: requirement.name,
+            message: `Value ${value} exceeds maximum ${requirement.max}`,
+            code: "ABOVE_MAX"
+          });
+        }
+      }
+      break;
+    case "boolean":
+      if (typeof value !== "boolean") {
+        errors.push({
+          field: requirement.name,
+          message: `Expected a boolean, got ${typeof value}`,
+          code: "INVALID_TYPE"
+        });
+      }
+      break;
+    case "select":
+      if (requirement.options && requirement.options.length > 0) {
+        const validValues = requirement.options.map((o) => o.value);
+        if (!validValues.includes(String(value))) {
+          errors.push({
+            field: requirement.name,
+            message: `Invalid selection. Valid options: ${validValues.join(", ")}`,
+            code: "INVALID_OPTION"
+          });
+        }
+      }
+      break;
+    case "multiselect":
+      if (!Array.isArray(value)) {
+        errors.push({
+          field: requirement.name,
+          message: "Expected an array for multiselect",
+          code: "INVALID_TYPE"
+        });
+      }
+      break;
+    case "string":
+    case "secret":
+      if (typeof value !== "string" && value !== void 0 && value !== null) {
+        errors.push({
+          field: requirement.name,
+          message: `Expected a string, got ${typeof value}`,
+          code: "INVALID_TYPE"
+        });
+      }
+      if (typeof value === "string") {
+        if (requirement.min !== void 0 && value.length < requirement.min) {
+          errors.push({
+            field: requirement.name,
+            message: `Value must be at least ${requirement.min} characters`,
+            code: "TOO_SHORT"
+          });
+        }
+        if (requirement.max !== void 0 && value.length > requirement.max) {
+          errors.push({
+            field: requirement.name,
+            message: `Value must be at most ${requirement.max} characters`,
+            code: "TOO_LONG"
+          });
+        }
+      }
+      break;
+  }
+  if (requirement.required && (value === void 0 || value === null || value === "")) {
+    errors.push({
+      field: requirement.name,
+      message: `${requirement.label || requirement.name} is required`,
+      code: "REQUIRED"
+    });
+  }
+  return {
+    valid: errors.length === 0,
+    errors,
+    warnings: []
+  };
+}
+function useAskIterator(options) {
+  const { element, onComplete, initialValues, preSuppliedValues, onMissingDefault } = options;
+  const [requirements, setRequirements] = react.useState([]);
+  const [currentIndex, setCurrentIndex] = react.useState(0);
+  const [values, setValues] = react.useState(() => new Map(initialValues));
+  const [isLoading, setIsLoading] = react.useState(false);
+  const onCompleteRef = react.useRef(onComplete);
+  onCompleteRef.current = onComplete;
+  const completedRef = react.useRef(false);
+  react.useEffect(() => {
+    if (!element) {
+      setRequirements([]);
+      setCurrentIndex(0);
+      setValues(new Map(initialValues));
+      completedRef.current = false;
+      return void 0;
+    }
+    let cancelled = false;
+    setIsLoading(true);
+    const extractOpts = preSuppliedValues ? { values: preSuppliedValues } : void 0;
+    void extractInputRequirements(element, extractOpts).then((reqs) => {
+      if (!cancelled) {
+        setRequirements(reqs);
+        setCurrentIndex(0);
+        setValues(new Map(initialValues));
+        completedRef.current = false;
+        setIsLoading(false);
+      }
+    });
+    return () => {
+      cancelled = true;
+    };
+  }, [element, initialValues, preSuppliedValues]);
+  const totalInputs = requirements.length;
+  const isDone = totalInputs > 0 ? currentIndex >= totalInputs : !isLoading;
+  const current = currentIndex < totalInputs ? requirements[currentIndex] ?? null : null;
+  react.useEffect(() => {
+    var _a;
+    if (isDone && totalInputs > 0 && !completedRef.current) {
+      completedRef.current = true;
+      (_a = onCompleteRef.current) == null ? void 0 : _a.call(onCompleteRef, new Map(values));
+    }
+  }, [isDone, totalInputs, values]);
+  const submit = react.useCallback(
+    (value) => {
+      if (!current) {
+        return Promise.resolve({
+          valid: false,
+          errors: [{ field: "", message: "No current requirement", code: "NO_REQUIREMENT" }],
+          warnings: []
+        });
+      }
+      const result = validateInput(current, value);
+      if (result.valid) {
+        setValues((prev) => {
+          const next = new Map(prev);
+          next.set(current.name, value);
+          return next;
+        });
+        setCurrentIndex((prev) => prev + 1);
+      }
+      return Promise.resolve(result);
+    },
+    [current]
+  );
+  const previous = react.useCallback(() => {
+    setCurrentIndex((prev) => Math.max(0, prev - 1));
+    completedRef.current = false;
+  }, []);
+  const goTo = react.useCallback(
+    (index) => {
+      if (index >= 0 && index < totalInputs) {
+        setCurrentIndex(index);
+        completedRef.current = false;
+      }
+    },
+    [totalInputs]
+  );
+  const reset = react.useCallback(() => {
+    setCurrentIndex(0);
+    setValues(/* @__PURE__ */ new Map());
+    completedRef.current = false;
+  }, []);
+  const setValue = react.useCallback((name, value) => {
+    setValues((prev) => {
+      const next = new Map(prev);
+      next.set(name, value);
+      return next;
+    });
+  }, []);
+  const getValue = react.useCallback(
+    (name) => {
+      return values.get(name);
+    },
+    [values]
+  );
+  const runNonInteractive = react.useCallback(async () => {
+    if (!element) {
+      return /* @__PURE__ */ new Map();
+    }
+    const iteratorOpts = {
+      validateOnSubmit: false,
+      environment: "browser",
+      nonInteractive: true,
+      onMissingDefault: onMissingDefault ?? "error"
+    };
+    if (preSuppliedValues) {
+      iteratorOpts.values = preSuppliedValues;
+    }
+    const iterator = lib.createInputIterator(element, iteratorOpts);
+    await iterator.start();
+    const result = await iterator.runNonInteractive();
+    setValues(result);
+    setCurrentIndex(requirements.length);
+    return result;
+  }, [element, preSuppliedValues, onMissingDefault, requirements.length]);
+  return {
+    requirements,
+    current,
+    currentIndex,
+    totalInputs,
+    isDone,
+    isLoading,
+    inputs: values,
+    submit,
+    previous,
+    goTo,
+    reset,
+    setValue,
+    getValue,
+    runNonInteractive
+  };
+}
+const INPUT_TYPE_MAP = {
+  string: "text",
+  number: "number",
+  boolean: "checkbox",
+  secret: "password",
+  date: "date",
+  path: "text",
+  select: "text",
+  multiselect: "text",
+  rating: "number"
+};
+function AskHandler({ children, element, onComplete, initialValues }) {
+  const {
+    requirements,
+    current,
+    currentIndex,
+    totalInputs,
+    isDone,
+    isLoading,
+    inputs: values,
+    submit,
+    previous,
+    goTo,
+    reset,
+    setValue,
+    getValue
+  } = useAskIterator({
+    element,
+    ...onComplete !== void 0 && { onComplete },
+    ...initialValues !== void 0 && { initialValues }
+  });
+  let progress;
+  if (totalInputs === 0) {
+    progress = isDone ? 100 : 0;
+  } else {
+    progress = Math.round(currentIndex / totalInputs * 100);
+  }
+  const getInputProps = react.useCallback(
+    (name) => {
+      const requirement = requirements.find((r) => r.name === name) ?? {
+        name,
+        label: name,
+        type: "string",
+        description: name,
+        required: false
+      };
+      const inputType = INPUT_TYPE_MAP[requirement.type] ?? "text";
+      return {
+        inputProps: {
+          id: `ask-${name}`,
+          name,
+          type: inputType,
+          required: requirement.required ?? false,
+          "aria-label": requirement.label
+        },
+        requirement,
+        value: getValue(name),
+        setValue: (value) => {
+          setValue(name, value);
+        },
+        errors: []
+      };
+    },
+    [requirements, getValue, setValue]
+  );
+  return /* @__PURE__ */ jsxRuntime.jsx(jsxRuntime.Fragment, { children: children({
+    requirements,
+    current,
+    currentIndex,
+    totalInputs,
+    progress,
+    isDone,
+    isLoading,
+    values,
+    submit,
+    previous,
+    goTo,
+    reset,
+    getInputProps
+  }) });
+}
+const DEFAULT_DEBOUNCE$1 = 300;
+function PromptEditor({
+  children,
+  defaultValue = "",
+  onChange,
+  debounce = DEFAULT_DEBOUNCE$1
+}) {
+  const [value, setValueState] = react.useState(defaultValue);
+  const [element, setElement] = react.useState(null);
+  const [error, setError] = react.useState(null);
+  const [isTransforming, setIsTransforming] = react.useState(false);
+  const timerRef = react.useRef(null);
+  const mountedRef = react.useRef(true);
+  react.useEffect(() => {
+    mountedRef.current = true;
+    return () => {
+      mountedRef.current = false;
+      if (timerRef.current !== null) {
+        clearTimeout(timerRef.current);
+      }
+    };
+  }, []);
+  const scheduleTransform = react.useCallback(
+    (source) => {
+      if (timerRef.current !== null) {
+        clearTimeout(timerRef.current);
+        timerRef.current = null;
+      }
+      if (source.trim() === "") {
+        setElement(null);
+        setError(null);
+        setIsTransforming(false);
+        return;
+      }
+      const doTransform = async () => {
+        timerRef.current = null;
+        if (!mountedRef.current) {
+          return;
+        }
+        setIsTransforming(true);
+        try {
+          const result = await transformSource(source);
+          if (mountedRef.current) {
+            setElement(result);
+            setError(null);
+          }
+        } catch (err) {
+          if (mountedRef.current) {
+            setElement(null);
+            setError(err instanceof Error ? err : new Error(String(err)));
+          }
+        } finally {
+          if (mountedRef.current) {
+            setIsTransforming(false);
+          }
+        }
+      };
+      if (debounce <= 0) {
+        void doTransform();
+      } else {
+        setIsTransforming(true);
+        timerRef.current = setTimeout(() => {
+          void doTransform();
+        }, debounce);
+      }
+    },
+    [debounce]
+  );
+  react.useEffect(() => {
+    if (defaultValue.trim() !== "") {
+      scheduleTransform(defaultValue);
+    }
+  }, []);
+  const handleChange = react.useCallback(
+    (e) => {
+      const newValue = e.target.value;
+      setValueState(newValue);
+      onChange == null ? void 0 : onChange(newValue);
+      scheduleTransform(newValue);
+    },
+    [onChange, scheduleTransform]
+  );
+  const setValue = react.useCallback(
+    (newValue) => {
+      setValueState(newValue);
+      onChange == null ? void 0 : onChange(newValue);
+      scheduleTransform(newValue);
+    },
+    [onChange, scheduleTransform]
+  );
+  return /* @__PURE__ */ jsxRuntime.jsx(jsxRuntime.Fragment, { children: children({
+    inputProps: {
+      value,
+      onChange: handleChange
+    },
+    value,
+    setValue,
+    element,
+    error,
+    isTransforming
+  }) });
+}
+function usePupt() {
+  const context = react.useContext(PuptContext);
+  if (!context._initialized) {
+    throw new Error("usePupt must be used within a PuptProvider");
+  }
+  return context;
+}
+function usePromptRender(options = {}) {
+  const {
+    source: initialSource,
+    inputs,
+    environment,
+    renderOptions: customRenderOptions,
+    autoRender = false,
+    filename
+  } = options;
+  const { renderOptions: contextRenderOptions, environment: contextEnvironment } = usePupt();
+  const [source, setSourceState] = react.useState(initialSource ?? null);
+  const [element, setElement] = react.useState(null);
+  const [output, setOutput] = react.useState(null);
+  const [error, setError] = react.useState(null);
+  const [isTransforming, setIsTransforming] = react.useState(false);
+  const [isRendering, setIsRendering] = react.useState(false);
+  const [inputRequirements, setInputRequirements] = react.useState([]);
+  const [postActions, setPostActions] = react.useState([]);
+  const [renderErrors, setRenderErrors] = react.useState([]);
+  const mountedRef = react.useRef(true);
+  react.useEffect(() => {
+    mountedRef.current = true;
+    return () => {
+      mountedRef.current = false;
+    };
+  }, []);
+  const doTransform = react.useCallback(
+    async (sourceToTransform) => {
+      setIsTransforming(true);
+      setError(null);
+      try {
+        let newElement;
+        if (sourceToTransform.type === "element") {
+          newElement = sourceToTransform.value;
+        } else {
+          newElement = await transformSource(sourceToTransform.value, filename ? { filename } : void 0);
+        }
+        if (mountedRef.current) {
+          setElement(newElement);
+          const requirements = await extractInputRequirements(newElement);
+          setInputRequirements(requirements);
+        }
+        return newElement;
+      } catch (err) {
+        if (mountedRef.current) {
+          setError(err instanceof Error ? err : new Error(String(err)));
+          setElement(null);
+          setInputRequirements([]);
+        }
+        return null;
+      } finally {
+        if (mountedRef.current) {
+          setIsTransforming(false);
+        }
+      }
+    },
+    [filename]
+  );
+  const doRender = react.useCallback(
+    async (elementToRender) => {
+      setIsRendering(true);
+      setError(null);
+      setRenderErrors([]);
+      try {
+        const mergedOptions = {
+          ...contextRenderOptions,
+          ...customRenderOptions,
+          inputs: inputs ?? /* @__PURE__ */ new Map()
+        };
+        const envOverrides = { ...contextEnvironment, ...environment };
+        if (Object.keys(envOverrides).length > 0) {
+          mergedOptions.env = lib.createEnvironment(envOverrides);
+        }
+        const result = await lib.render(elementToRender, mergedOptions);
+        if (mountedRef.current) {
+          setOutput(result.text);
+          setPostActions(result.postExecution ?? []);
+          if (!result.ok && "errors" in result) {
+            setRenderErrors(result.errors);
+            const firstError = result.errors[0];
+            if (firstError) {
+              setError(new Error(`${firstError.component}: ${firstError.message}`));
+            }
+          } else {
+            setRenderErrors([]);
+          }
+        }
+      } catch (err) {
+        if (mountedRef.current) {
+          setError(err instanceof Error ? err : new Error(String(err)));
+          setOutput(null);
+          setPostActions([]);
+        }
+      } finally {
+        if (mountedRef.current) {
+          setIsRendering(false);
+        }
+      }
+    },
+    [contextRenderOptions, contextEnvironment, customRenderOptions, environment, inputs]
+  );
+  const transform = react.useCallback(
+    async (sourceCode) => {
+      const sourceToUse = sourceCode ? { type: "source", value: sourceCode } : source;
+      if (!sourceToUse) {
+        return null;
+      }
+      if (sourceCode) {
+        setSourceState({ type: "source", value: sourceCode });
+      }
+      return doTransform(sourceToUse);
+    },
+    [source, doTransform]
+  );
+  const render = react.useCallback(async () => {
+    if (element) {
+      await doRender(element);
+    }
+  }, [element, doRender]);
+  const setSource = react.useCallback((newSource) => {
+    setSourceState(newSource);
+  }, []);
+  const externalSourceValue = (initialSource == null ? void 0 : initialSource.type) === "source" ? initialSource.value : null;
+  const prevExternalSourceValue = react.useRef(externalSourceValue);
+  react.useEffect(() => {
+    if (externalSourceValue !== prevExternalSourceValue.current) {
+      prevExternalSourceValue.current = externalSourceValue;
+      if (initialSource) {
+        setSourceState(initialSource);
+      }
+    }
+  }, [externalSourceValue, initialSource]);
+  react.useEffect(() => {
+    if (source) {
+      void doTransform(source);
+    } else {
+      setElement(null);
+      setInputRequirements([]);
+      setError(null);
+    }
+  }, [source, doTransform]);
+  react.useEffect(() => {
+    if (autoRender && element) {
+      void doRender(element);
+    }
+  }, [autoRender, element, doRender]);
+  react.useEffect(() => {
+    if (autoRender && element && inputs) {
+      void doRender(element);
+    }
+  }, [autoRender, element, inputs, doRender]);
+  return {
+    source,
+    setSource,
+    element,
+    output,
+    error,
+    renderErrors,
+    isTransforming,
+    isRendering,
+    isLoading: isTransforming || isRendering,
+    inputRequirements,
+    postActions,
+    render,
+    transform
+  };
+}
+function PromptRenderer({
+  children,
+  source,
+  autoRender = true,
+  inputs,
+  renderOptions,
+  environment,
+  filename
+}) {
+  const [isCopied, setIsCopied] = react.useState(false);
+  const normalizedSource = react.useMemo(
+    () => typeof source === "string" ? { type: "source", value: source } : source,
+    [source]
+  );
+  const {
+    output,
+    error,
+    isLoading,
+    inputRequirements,
+    postActions,
+    render: doRender
+  } = usePromptRender({
+    source: normalizedSource,
+    autoRender,
+    ...inputs !== void 0 && { inputs },
+    ...renderOptions !== void 0 && { renderOptions },
+    ...environment !== void 0 && { environment },
+    ...filename !== void 0 && { filename }
+  });
+  const isReady = output !== null && inputRequirements.length === 0;
+  const copyToClipboard = react.useCallback(async () => {
+    if (output === null) {
+      return;
+    }
+    try {
+      await navigator.clipboard.writeText(output);
+      setIsCopied(true);
+      setTimeout(() => {
+        setIsCopied(false);
+      }, 2e3);
+    } catch {
+    }
+  }, [output]);
+  const render = react.useCallback(async () => {
+    await doRender();
+  }, [doRender]);
+  return /* @__PURE__ */ jsxRuntime.jsx(jsxRuntime.Fragment, { children: children({
+    output,
+    isReady,
+    isLoading,
+    error,
+    pendingInputs: inputRequirements,
+    postActions,
+    copyToClipboard,
+    isCopied,
+    render
+  }) });
+}
+function PuptProvider({
+  children,
+  prompts,
+  searchConfig,
+  renderOptions = {},
+  environment = {}
+}) {
+  const [isLoading] = react.useState(false);
+  const [error] = react.useState(null);
+  const searchEngine = react.useMemo(() => {
+    if (!prompts || prompts.length === 0) {
+      return null;
+    }
+    try {
+      const engine = lib.createSearchEngine(searchConfig);
+      engine.index(prompts);
+      return engine;
+    } catch (err) {
+      console.error("Failed to initialize search engine:", err);
+      return null;
+    }
+  }, [prompts, searchConfig]);
+  const contextValue = react.useMemo(
+    () => ({
+      _initialized: true,
+      searchEngine,
+      prompts: prompts ?? [],
+      renderOptions,
+      environment,
+      isLoading,
+      error
+    }),
+    [searchEngine, prompts, renderOptions, environment, isLoading, error]
+  );
+  return /* @__PURE__ */ jsxRuntime.jsx(PuptContext.Provider, { value: contextValue, children });
+}
+function useFormula(options) {
+  const { formula, inputs } = options;
+  return react.useMemo(() => {
+    try {
+      return { result: lib.evaluateFormula(formula, inputs), error: null };
+    } catch (err) {
+      return {
+        result: false,
+        error: err instanceof Error ? err : new Error(String(err))
+      };
+    }
+  }, [formula, inputs]);
+}
+function usePostActions(options) {
+  const { actions, handlers } = options;
+  const [executedSet, setExecutedSet] = react.useState(() => /* @__PURE__ */ new Set());
+  const [dismissedSet, setDismissedSet] = react.useState(() => /* @__PURE__ */ new Set());
+  const prevActionsRef = react.useRef(actions);
+  if (prevActionsRef.current !== actions) {
+    prevActionsRef.current = actions;
+    setExecutedSet(/* @__PURE__ */ new Set());
+    setDismissedSet(/* @__PURE__ */ new Set());
+  }
+  const pendingActions = actions.filter((a) => !executedSet.has(a) && !dismissedSet.has(a));
+  const executedActions = actions.filter((a) => executedSet.has(a));
+  const dismissedActions = actions.filter((a) => dismissedSet.has(a));
+  const allDone = pendingActions.length === 0;
+  const execute = react.useCallback(
+    async (action) => {
+      if (executedSet.has(action)) {
+        return;
+      }
+      const handler = handlers == null ? void 0 : handlers[action.type];
+      if (handler) {
+        await handler(action);
+      }
+      setExecutedSet((prev) => {
+        const next = new Set(prev);
+        next.add(action);
+        return next;
+      });
+    },
+    [handlers, executedSet]
+  );
+  const dismiss = react.useCallback((action) => {
+    setDismissedSet((prev) => {
+      const next = new Set(prev);
+      next.add(action);
+      return next;
+    });
+  }, []);
+  const executeAll = react.useCallback(async () => {
+    for (const action of pendingActions) {
+      const handler = handlers == null ? void 0 : handlers[action.type];
+      if (handler) {
+        await handler(action);
+      }
+    }
+    setExecutedSet((prev) => {
+      const next = new Set(prev);
+      for (const action of pendingActions) {
+        next.add(action);
+      }
+      return next;
+    });
+  }, [pendingActions, handlers]);
+  const dismissAll = react.useCallback(() => {
+    setDismissedSet((prev) => {
+      const next = new Set(prev);
+      for (const action of pendingActions) {
+        next.add(action);
+      }
+      return next;
+    });
+  }, [pendingActions]);
+  const reset = react.useCallback(() => {
+    setExecutedSet(/* @__PURE__ */ new Set());
+    setDismissedSet(/* @__PURE__ */ new Set());
+  }, []);
+  return {
+    pendingActions,
+    executedActions,
+    dismissedActions,
+    allDone,
+    execute,
+    dismiss,
+    executeAll,
+    dismissAll,
+    reset
+  };
+}
+const DEFAULT_DEBOUNCE = 200;
+function usePromptSearch(options = {}) {
+  const { debounce = DEFAULT_DEBOUNCE, limit } = options;
+  const { searchEngine } = usePupt();
+  const [query, setQueryState] = react.useState("");
+  const [results, setResults] = react.useState([]);
+  const [isSearching, setIsSearching] = react.useState(false);
+  const timerRef = react.useRef(null);
+  const performSearch = react.useCallback(
+    (searchQuery) => {
+      if (!searchEngine || searchQuery.trim() === "") {
+        setResults([]);
+        setIsSearching(false);
+        return;
+      }
+      setIsSearching(true);
+      try {
+        const searchOptions = limit !== void 0 ? { limit } : {};
+        const searchResults = searchEngine.search(searchQuery, searchOptions);
+        setResults(searchResults);
+      } finally {
+        setIsSearching(false);
+      }
+    },
+    [searchEngine, limit]
+  );
+  const setQuery = react.useCallback(
+    (newQuery) => {
+      setQueryState(newQuery);
+      if (timerRef.current !== null) {
+        clearTimeout(timerRef.current);
+        timerRef.current = null;
+      }
+      if (newQuery.trim() === "") {
+        setResults([]);
+        setIsSearching(false);
+        return;
+      }
+      if (debounce <= 0) {
+        performSearch(newQuery);
+      } else {
+        setIsSearching(true);
+        timerRef.current = setTimeout(() => {
+          timerRef.current = null;
+          performSearch(newQuery);
+        }, debounce);
+      }
+    },
+    [debounce, performSearch]
+  );
+  const clear = react.useCallback(() => {
+    if (timerRef.current !== null) {
+      clearTimeout(timerRef.current);
+      timerRef.current = null;
+    }
+    setQueryState("");
+    setResults([]);
+    setIsSearching(false);
+  }, []);
+  const allTags = searchEngine ? searchEngine.getAllTags() : [];
+  react.useEffect(() => {
+    return () => {
+      if (timerRef.current !== null) {
+        clearTimeout(timerRef.current);
+      }
+    };
+  }, []);
+  return {
+    query,
+    setQuery,
+    results,
+    isSearching,
+    allTags,
+    clear
+  };
+}
+function usePuptLibraryContext() {
+  const ctx = react.useContext(PuptLibraryContext);
+  if (!ctx) {
+    throw new Error("usePuptLibraryContext must be used within a PuptLibraryProvider");
+  }
+  return ctx;
+}
+const VERSION = "1.0.0";
+Object.defineProperty(exports, "CHILDREN", {
+  enumerable: true,
+  get: () => lib.CHILDREN
+});
+Object.defineProperty(exports, "COMPONENT_MARKER", {
+  enumerable: true,
+  get: () => lib.COMPONENT_MARKER
+});
+Object.defineProperty(exports, "Component", {
+  enumerable: true,
+  get: () => lib.Component
+});
+Object.defineProperty(exports, "DEFERRED_REF", {
+  enumerable: true,
+  get: () => lib.DEFERRED_REF
+});
+Object.defineProperty(exports, "PROPS", {
+  enumerable: true,
+  get: () => lib.PROPS
+});
+Object.defineProperty(exports, "TYPE", {
+  enumerable: true,
+  get: () => lib.TYPE
+});
+Object.defineProperty(exports, "createRuntimeConfig", {
+  enumerable: true,
+  get: () => lib.createRuntimeConfig
+});
+Object.defineProperty(exports, "evaluateFormula", {
+  enumerable: true,
+  get: () => lib.evaluateFormula
+});
+Object.defineProperty(exports, "isComponentClass", {
+  enumerable: true,
+  get: () => lib.isComponentClass
+});
+Object.defineProperty(exports, "isDeferredRef", {
+  enumerable: true,
+  get: () => lib.isDeferredRef
+});
+Object.defineProperty(exports, "isPuptElement", {
+  enumerable: true,
+  get: () => lib.isPuptElement
+});
+exports.AskHandler = AskHandler;
+exports.PromptEditor = PromptEditor;
+exports.PromptRenderer = PromptRenderer;
+exports.PuptContext = PuptContext;
+exports.PuptLibraryContext = PuptLibraryContext;
+exports.PuptLibraryProvider = PuptLibraryProvider;
+exports.PuptProvider = PuptProvider;
+exports.VERSION = VERSION;
+exports.extractInputRequirements = extractInputRequirements;
+exports.isAskComponent = isAskComponent;
+exports.isElement = isElement;
+exports.transformSource = transformSource;
+exports.traverseElement = traverseElement;
+exports.useAskIterator = useAskIterator;
+exports.useFormula = useFormula;
+exports.usePostActions = usePostActions;
+exports.usePromptRender = usePromptRender;
+exports.usePromptSearch = usePromptSearch;
+exports.usePupt = usePupt;
+exports.usePuptLibrary = usePuptLibrary;
+exports.usePuptLibraryContext = usePuptLibraryContext;
+exports.validateInput = validateInput;
+//# sourceMappingURL=index.cjs.map