treege 3.0.0-beta.43 → 3.0.0-beta.45

package/dist/renderer/features/TreegeRenderer/web/TreegeRenderer.d.ts

@@ -1,3 +1,3 @@
 import { TreegeRendererProps } from '../../../types/renderer';
-declare const TreegeRenderer: ({ components, className, flows, googleApiKey, language, onChange, onSubmit, theme, validate, validationMode, initialValues, }: TreegeRendererProps) => import("react/jsx-runtime").JSX.Element;
+declare const TreegeRenderer: ({ components, className, flows, googleApiKey, headers, language, onChange, onSubmit, theme, validate, validationMode, initialValues, }: TreegeRendererProps) => import("react/jsx-runtime").JSX.Element;
 export default TreegeRenderer;

package/dist/renderer/features/TreegeRenderer/web/components/DefaultFormWrapper.d.ts

@@ -1,6 +1,6 @@
 import { FormEvent, ReactNode } from 'react';
 declare const DefaultFormWrapper: ({ children, onSubmit }: {
     children: ReactNode;
-    onSubmit: (e: FormEvent) => void;
+    onSubmit: (e: FormEvent<HTMLFormElement>) => void;
 }) => import("react/jsx-runtime").JSX.Element;
 export default DefaultFormWrapper;

package/dist/renderer/features/TreegeRenderer/web/components/DefaultInputWrapper.d.ts

@@ -0,0 +1,9 @@
+import { Node } from '@xyflow/react';
+import { ReactNode } from 'react';
+import { InputNodeData } from '../../../../../shared/types/node';
+interface DefaultInputWrapperProps {
+    node: Node<InputNodeData>;
+    children: ReactNode;
+}
+export declare const DefaultInputWrapper: ({ node, children }: DefaultInputWrapperProps) => import("react/jsx-runtime").JSX.Element;
+export default DefaultInputWrapper;

package/dist/renderer/features/TreegeRenderer/web/components/styles/RendererStyles.d.ts

@@ -0,0 +1,2 @@
+declare const RendererStyles: () => import("react/jsx-runtime").JSX.Element;
+export default RendererStyles;

package/dist/renderer/hooks/useInputOptions.d.ts

@@ -0,0 +1,28 @@
+import { Node } from '@xyflow/react';
+import { InputNodeData, InputOption } from '../../shared/types/node';
+interface UseInputOptionsResult {
+    /**
+     * Resolved options for the input. When the node has an `optionsSource`,
+     * these are the fetched options (or the static fallback while loading or
+     * if the fetch errors). Otherwise the static `options` from the node data.
+     */
+    options: InputOption[];
+    /** True while a remote fetch is in flight. */
+    isLoading: boolean;
+    /** Error message if the latest remote fetch failed; otherwise `null`. */
+    error: string | null;
+}
+/**
+ * Resolves the options for an option-based input (radio, checkbox, select,
+ * autocomplete). If the node declares an `optionsSource`, options are fetched
+ * from that API at runtime, with `{{templateVar}}` substitution from form
+ * values and merging of global + field-level headers. While loading, before
+ * the first successful fetch, or on error, falls back to the static
+ * `options` array (if any).
+ *
+ * The fetch plan is computed once and serialized to JSON. The fetch effect
+ * keys off this string: changes that don't affect the actual request (e.g.
+ * an unrelated form field) produce the same JSON and don't re-trigger.
+ */
+export declare const useInputOptions: (node: Node<InputNodeData>) => UseInputOptionsResult;
+export {};

package/dist/renderer/hooks/useRenderNode.d.ts

@@ -1,7 +1,7 @@
 import { Node } from '@xyflow/react';
 import { ComponentType, ReactNode } from 'react';
 import { FormValues, InputRenderers, TreegeRendererComponents } from '../types/renderer';
-import { TreegeNodeData } from '../../shared/types/node';
+import { InputNodeData, TreegeNodeData } from '../../shared/types/node';
 type AnyComponent = ComponentType<any>;
 type UseRenderNodeParams = {
     config: {
@@ -10,6 +10,10 @@ type UseRenderNodeParams = {
     };
     DefaultFormWrapper: AnyComponent;
     DefaultGroup: AnyComponent;
+    DefaultInputWrapper: ComponentType<{
+        node: Node<InputNodeData>;
+        children: ReactNode;
+    }>;
     DefaultSubmitButton: AnyComponent;
     DefaultSubmitButtonWrapper?: AnyComponent;
     defaultInputRenderers: InputRenderers;
@@ -30,10 +34,10 @@ type UseRenderNodeParams = {
  * - SubmitButton: Submit button component with fallback
  * - SubmitButtonWrapper: Submit button wrapper component with fallback (web only, undefined for native)
  */
-export declare const useRenderNode: ({ DefaultFormWrapper, DefaultGroup, DefaultSubmitButton, DefaultSubmitButtonWrapper, config, defaultInputRenderers, defaultUI, formErrors, formValues, missingRequiredFields, setFieldValue, visibleNodes, }: UseRenderNodeParams) => {
+export declare const useRenderNode: ({ DefaultFormWrapper, DefaultGroup, DefaultInputWrapper, DefaultSubmitButton, DefaultSubmitButtonWrapper, config, defaultInputRenderers, defaultUI, formErrors, formValues, missingRequiredFields, setFieldValue, visibleNodes, }: UseRenderNodeParams) => {
     FormWrapper: ((props: {
         children: ReactNode;
-        onSubmit: (e: import('react').FormEvent) => void;
+        onSubmit: (e: import('react').FormEvent<HTMLFormElement>) => void;
     }) => ReactNode) | AnyComponent;
     renderNode: (node: Node<TreegeNodeData>) => ReactNode;
     SubmitButton: ((props: {

package/dist/renderer/hooks/useSubmitHandler.d.ts

@@ -1,7 +1,7 @@
 import { Node } from '@xyflow/react';
 import { FormValues } from '../types/renderer';
 import { SubmitResult } from '../utils/submit';
-import { InputNodeData, TreegeNodeData } from '../../shared/types/node';
+import { HttpHeader, InputNodeData, TreegeNodeData } from '../../shared/types/node';
 /**
  * Hook for handling form submission with submit button configuration
  *
@@ -16,9 +16,10 @@ import { InputNodeData, TreegeNodeData } from '../../shared/types/node';
  * @param formValues - Current form values
  * @param language - Current language for translations
  * @param inputNodes - All input nodes for form data conversion
+ * @param headers
  * @returns Submit handler state and functions
  */
-export declare const useSubmitHandler: (visibleNodes: Node<TreegeNodeData>[], formValues: FormValues, language: string, inputNodes: Node<InputNodeData>[]) => {
+export declare const useSubmitHandler: (visibleNodes: Node<TreegeNodeData>[], formValues: FormValues, language: string, inputNodes: Node<InputNodeData>[], headers?: HttpHeader[]) => {
     clearSubmitMessage: () => void;
     handleSubmitWithConfig: (onSuccess?: (data: unknown) => void) => Promise<SubmitResult | null>;
     hasSubmitConfig: boolean;

package/dist/renderer/types/renderer.d.ts

@@ -1,7 +1,7 @@
 import { Node } from '@xyflow/react';
 import { FormEvent, ReactNode } from 'react';
 import { SerializableFile } from '../utils/file';
-import { Flow, InputNodeData, InputType, TreegeNodeData, UINodeData, UIType } from '../../shared/types/node';
+import { Flow, HttpHeader, InputNodeData, InputType, TreegeNodeData, UINodeData, UIType } from '../../shared/types/node';
 /**
  * Type mapping for input values based on input type
  */
@@ -128,7 +128,7 @@ export type TreegeRendererComponents = {
      */
     form?: (props: {
         children: ReactNode;
-        onSubmit: (e: FormEvent) => void;
+        onSubmit: (e: FormEvent<HTMLFormElement>) => void;
     }) => ReactNode;
     /**
      * Custom submit button (supports both web and native variants)
@@ -163,6 +163,12 @@ export type TreegeRendererConfig = {
      * Custom component renderers
      */
     components?: TreegeRendererComponents;
+    /**
+     * Global HTTP headers applied to every request issued by the renderer
+     * (HTTP inputs, submit buttons). Field-level headers with the same key
+     * (case-insensitive) take precedence over these.
+     */
+    headers?: HttpHeader[];
     /**
      * Google Maps API key for address autocomplete
      * If not provided, falls back to free Nominatim (OpenStreetMap)
@@ -186,35 +192,26 @@ export type TreegeRendererConfig = {
 };
 /**
  * Props for the TreegeRenderer component
+ *
+ * Inherits all configuration fields from TreegeRendererConfig (components,
+ * headers, googleApiKey, language, theme, validationMode) and adds the
+ * instance-specific ones (flows, callbacks, initial values, etc.).
  */
-export interface TreegeRendererProps {
+export interface TreegeRendererProps extends TreegeRendererConfig {
     /**
      * Additional class name for the renderer container
      */
     className?: string;
-    /**
-     * Custom component renderers
-     */
-    components?: TreegeRendererComponents;
     /**
      * Flow or array of flows
      * - If a single Flow: renders that flow
      * - If an array: first flow is the main flow, others are sub-flows available for FlowNodes
      */
     flows?: Flow | Flow[] | null;
-    /**
-     * Google Maps API key for address autocomplete
-     * If not provided, falls back to free Nominatim (OpenStreetMap)
-     */
-    googleApiKey?: string;
     /**
      * Initial form values
      */
     initialValues?: FormValues;
-    /**
-     * Current language for translations
-     */
-    language?: string;
     /**
      * Callback when form values change
      */
@@ -225,17 +222,8 @@ export interface TreegeRendererProps {
      * @param meta - Optional metadata about the submission (e.g., HTTP response data)
      */
     onSubmit?: (values: FormValues, meta?: Meta) => void;
-    /**
-     * Theme for the renderer
-     * @default "dark"
-     */
-    theme?: "dark" | "light";
     /**
      * Custom validation function
      */
     validate?: (values: FormValues, nodes: Node<TreegeNodeData>[]) => Record<string, string>;
-    /**
-     * Validation mode
-     */
-    validationMode?: "onChange" | "onSubmit";
 }

package/dist/renderer/utils/http.d.ts

@@ -1,5 +1,12 @@
 import { FormValues } from '../types/renderer';
-import { HttpHeader } from '../../shared/types/node';
+import { HttpHeader, InputOption, OptionsSourceMapping } from '../../shared/types/node';
+/**
+ * Merge multiple lists of HTTP headers. Later sources override earlier ones
+ * when they specify the same key (case-insensitive comparison, since HTTP
+ * header names are case-insensitive). The casing of the latest occurrence
+ * is preserved in the output.
+ */
+export declare const mergeHttpHeaders: (...sources: (HttpHeader[] | undefined)[]) => HttpHeader[];
 /**
  * Result of an HTTP request
  */
@@ -45,6 +52,10 @@ export interface HttpRequestOptions {
      * Request body (for POST/PUT/PATCH)
      */
     body?: string;
+    /**
+     * Optional abort signal to cancel the request
+     */
+    signal?: AbortSignal;
 }
 /**
  * Make an HTTP request with common error handling and response parsing
@@ -99,3 +110,20 @@ export declare const replaceTemplateVariables: (template: string | undefined, va
  * @returns The string with variables replaced
  */
 export declare const replaceResponseVariables: (template: string | undefined, responseData: unknown) => string;
+/**
+ * Extract a value from an object using a path that supports dot notation
+ * and array indexing. Examples:
+ * - "data.users" → obj.data.users
+ * - "results[0].name" → obj.results[0].name
+ *
+ * @param obj - The object to extract value from
+ * @param path - The path expression (empty string returns the object as-is)
+ * @returns The value at the path, or undefined if not found
+ */
+export declare const getValueByPath: (obj: unknown, path: string) => unknown;
+/**
+ * Project a list-shaped HTTP response into InputOption objects, applying
+ * a field-to-property mapping. Returns an empty array when the data is not
+ * iterable or required fields are missing.
+ */
+export declare const extractOptionsFromResponse: (response: unknown, responsePath: string | undefined, mapping: OptionsSourceMapping) => InputOption[];

package/dist/renderer/utils/submit.d.ts

@@ -1,6 +1,6 @@
 import { Node } from '@xyflow/react';
 import { FormValues } from '../types/renderer';
-import { InputNodeData, SubmitConfig } from '../../shared/types/node';
+import { HttpHeader, InputNodeData, SubmitConfig } from '../../shared/types/node';
 /**
  * Result of a form submission
  */
@@ -34,9 +34,10 @@ export interface SubmitResult {
  * @param config - Submit configuration from the submit button node
  * @param formValues - Current form values
  * @param inputNodes - All input nodes (required when sendAllFormValues is true)
+ * @param headers
  * @returns Promise with submission result
  */
-export declare const submitFormData: (config: SubmitConfig, formValues: FormValues, inputNodes: Node<InputNodeData>[]) => Promise<SubmitResult>;
+export declare const submitFormData: (config: SubmitConfig, formValues: FormValues, inputNodes: Node<InputNodeData>[], headers?: HttpHeader[]) => Promise<SubmitResult>;
 /**
  * Perform redirect to the specified URL
  *