treege 2.1.0 → 3.0.0-beta.2

package/dist/renderer/context/TreegeConfigContext.d.ts

@@ -0,0 +1,39 @@
+import { ReactNode } from 'react';
+import { TreegeRendererComponents, TreegeRendererConfig } from '../types/renderer';
+/**
+ * Hook to access the global Treege configuration
+ * Returns undefined if used outside of TreegeConfigProvider
+ */
+export declare const useTreegeConfig: () => TreegeRendererConfig | undefined;
+export type TreegeConfigProviderProps = {
+    children: ReactNode;
+    /**
+     * Custom component renderers (can be overridden per TreegeRenderer instance)
+     */
+    components?: TreegeRendererComponents;
+    /**
+     * Google Maps API key for address autocomplete
+     * If not provided, falls back to free Nominatim (OpenStreetMap)
+     */
+    googleApiKey?: string;
+    /**
+     * Default language for translations
+     * @default "en"
+     */
+    language?: string;
+    /**
+     * Default theme for all renderers
+     * @default "dark"
+     */
+    theme?: "dark" | "light";
+    /**
+     * Default validation mode
+     * @default "onSubmit"
+     */
+    validationMode?: "onChange" | "onSubmit";
+};
+/**
+ * Provider for global Treege configuration
+ * Wrap your app with this provider to set default options for all TreegeRenderer instances
+ */
+export declare const TreegeConfigProvider: ({ children, components, googleApiKey, language, theme, validationMode, }: TreegeConfigProviderProps) => import("react/jsx-runtime").JSX.Element;

package/dist/renderer/context/TreegeRendererContext.d.ts

@@ -0,0 +1,25 @@
+import { PropsWithChildren } from 'react';
+import { FormValues } from '../types/renderer';
+import { Flow } from '../../shared/types/node';
+export interface TreegeRendererContextValue {
+    flows?: Flow | null;
+    formErrors: Record<string, string>;
+    formValues: FormValues;
+    googleApiKey?: string;
+    language: string;
+    setFieldValue: (fieldName: string, value: unknown) => void;
+}
+export interface TreegeRendererProviderProps extends PropsWithChildren {
+    value: TreegeRendererContextValue;
+}
+export declare const TreegeRendererContext: import('react').Context<TreegeRendererContextValue | null>;
+export declare const TreegeRendererProvider: ({ children, value }: TreegeRendererProviderProps) => import("react/jsx-runtime").JSX.Element;
+export declare const useTreegeRendererContext: () => {
+    edges: import('@xyflow/react').Edge[];
+    flows?: Flow | null;
+    formErrors: Record<string, string>;
+    formValues: FormValues;
+    googleApiKey?: string;
+    language: string;
+    setFieldValue: (fieldName: string, value: unknown) => void;
+};

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

@@ -0,0 +1,13 @@
+/**
+ * TreegeRenderer for React Native
+ *
+ * TODO: Implement React Native version of TreegeRenderer
+ * This will use React Native components (View, Text, TextInput, etc.) instead of HTML elements
+ *
+ * The implementation should:
+ * - Import and use useTreegeRenderer hook (platform-agnostic)
+ * - Import and use utils from @/renderer/utils (platform-agnostic)
+ * - Use React Native UI components instead of web components
+ * - Share the same props interface (TreegeRendererProps)
+ */
+export {};

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

@@ -0,0 +1,7 @@
+/**
+ * Default Form Wrapper for React Native
+ *
+ * TODO: Implement React Native version of FormWrapper
+ * Should use View component and handle form submission with native patterns
+ */
+export {};

package/dist/renderer/features/TreegeRenderer/native/components/DefaultGroup.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Default Group Component for React Native
+ *
+ * TODO: Implement React Native version of Group component
+ * Should use View component with proper styling for grouping
+ */
+export {};

package/dist/renderer/features/TreegeRenderer/native/components/DefaultHttpInput.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Default Input Components for React Native
+ *
+ * TODO: Implement React Native versions of all input renderers
+ * This should mirror the web version but use React Native components:
+ * - TextInput instead of <input>
+ * - Picker instead of <select>
+ * - Switch instead of <input type="checkbox">
+ * - etc.
+ *
+ * Should export:
+ * - defaultInputRenderers object with all input types
+ * - Individual input components (DefaultTextInput, DefaultNumberInput, etc.)
+ */
+export {};

package/dist/renderer/features/TreegeRenderer/native/components/DefaultInputs.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Default Input Components for React Native
+ *
+ * TODO: Implement React Native versions of all input renderers
+ * This should mirror the web version but use React Native components:
+ * - TextInput instead of <input>
+ * - Picker instead of <select>
+ * - Switch instead of <input type="checkbox">
+ * - etc.
+ *
+ * Should export:
+ * - defaultInputRenderers object with all input types
+ * - Individual input components (DefaultTextInput, DefaultNumberInput, etc.)
+ */
+export {};

package/dist/renderer/features/TreegeRenderer/native/components/DefaultSubmitButton.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Default Submit Button for React Native
+ *
+ * TODO: Implement React Native version of SubmitButton
+ * Should use Pressable or TouchableOpacity component
+ */
+export {};

package/dist/renderer/features/TreegeRenderer/native/components/DefaultUI.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Default UI Components for React Native
+ *
+ * TODO: Implement React Native versions of UI components (Title, Description, Divider, etc.)
+ * Should use Text, View and other React Native components
+ */
+export {};

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

@@ -0,0 +1,50 @@
+import { Node } from '@xyflow/react';
+import { FormValues } from '../../types/renderer';
+import { Flow, TreegeNodeData } from '../../../shared/types/node';
+/**
+ * PURE STATE LOGIC HOOK
+ *
+ * This hook manages the internal form state and visibility logic.
+ * It contains NO side effects (no useEffect).
+ * All state is keyed by nodeId for uniqueness.
+ *
+ * Responsibilities:
+ * - Form values state (keyed by nodeId)
+ * - Errors state
+ * - Node visibility calculation (progressive rendering)
+ * - Form validation (built-in: required, pattern)
+ * - Submit button state (combines end-of-path detection + form validity)
+ *
+ * NOT responsible for:
+ * - Export/conversion to external format (done in component)
+ * - Side effects like onChange callbacks (done in component)
+ * - Custom validation (passed to component)
+ */
+/**
+ * Custom hook for TreegeRenderer - Pure state logic only
+ *
+ * @param flows - Flow or array of flows (can be null/undefined)
+ * @param initialValues - Initial form values (will be merged with node defaults)
+ * @param language - Preferred language for translations (defaults to 'en')
+ * @returns Pure state and computed values (no side effects)
+ */
+export declare const useTreegeRenderer: (flows: Flow | Flow[] | null | undefined, initialValues?: FormValues, language?: string) => {
+    canSubmit: boolean;
+    formErrors: Record<string, string>;
+    formValues: FormValues;
+    inputNodes: Node<import('../../../shared/types/node').InputNodeData>[];
+    mergedFlow: Flow;
+    missingRequiredFields: string[];
+    setFieldValue: (fieldName: string, value: unknown) => void;
+    setFormErrors: import('react').Dispatch<import('react').SetStateAction<Record<string, string>>>;
+    t: (key?: import('../../../main').Translatable | import('../../../main').TranslationKey | string) => string;
+    validateForm: (customValidate?: (values: FormValues, visibleNodesList: Node<TreegeNodeData>[]) => Record<string, string>) => {
+        errors: {
+            [x: string]: string;
+        };
+        hasCustomErrors: boolean;
+        isValid: boolean;
+    };
+    visibleNodes: Node<TreegeNodeData>[];
+    visibleRootNodes: Node<TreegeNodeData>[];
+};

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

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

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

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

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

@@ -0,0 +1,6 @@
+import { ReactNode } from 'react';
+import { NodeRenderProps } from '../../../../types/renderer';
+export declare const DefaultGroup: ({ node, children }: NodeRenderProps & {
+    children: ReactNode;
+}) => import("react/jsx-runtime").JSX.Element;
+export default DefaultGroup;

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

@@ -0,0 +1,20 @@
+import { default as DefaultAddressInput } from './inputs/DefaultAddressInput';
+import { default as DefaultAutocompleteInput } from './inputs/DefaultAutocompleteInput';
+import { default as DefaultCheckboxInput } from './inputs/DefaultCheckboxInput';
+import { default as DefaultDateInput } from './inputs/DefaultDateInput';
+import { default as DefaultDateRangeInput } from './inputs/DefaultDateRangeInput';
+import { default as DefaultFileInput } from './inputs/DefaultFileInput';
+import { default as DefaultHiddenInput } from './inputs/DefaultHiddenInput';
+import { default as DefaultHttpInput } from './inputs/DefaultHttpInput';
+import { default as DefaultNumberInput } from './inputs/DefaultNumberInput';
+import { default as DefaultPasswordInput } from './inputs/DefaultPasswordInput';
+import { default as DefaultRadioInput } from './inputs/DefaultRadioInput';
+import { default as DefaultSelectInput } from './inputs/DefaultSelectInput';
+import { default as DefaultSwitchInput } from './inputs/DefaultSwitchInput';
+import { default as DefaultTextAreaInput } from './inputs/DefaultTextAreaInput';
+import { default as DefaultTextInput } from './inputs/DefaultTextInput';
+import { default as DefaultTimeInput } from './inputs/DefaultTimeInput';
+import { default as DefaultTimeRangeInput } from './inputs/DefaultTimeRangeInput';
+import { InputRenderers } from '../../../../types/renderer';
+export { DefaultAddressInput, DefaultAutocompleteInput, DefaultCheckboxInput, DefaultDateInput, DefaultDateRangeInput, DefaultFileInput, DefaultHiddenInput, DefaultHttpInput, DefaultNumberInput, DefaultPasswordInput, DefaultRadioInput, DefaultSelectInput, DefaultSwitchInput, DefaultTextAreaInput, DefaultTextInput, DefaultTimeInput, DefaultTimeRangeInput, };
+export declare const defaultInputRenderers: InputRenderers;

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

@@ -0,0 +1,9 @@
+import { ButtonHTMLAttributes } from 'react';
+export interface SubmitButtonProps extends ButtonHTMLAttributes<HTMLButtonElement> {
+    label?: string;
+}
+/**
+ * Default submit button
+ */
+declare const DefaultSubmitButton: ({ label, ...props }: SubmitButtonProps) => import("react/jsx-runtime").JSX.Element;
+export default DefaultSubmitButton;

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

@@ -0,0 +1,10 @@
+import { ReactNode } from 'react';
+export interface SubmitButtonWrapperProps {
+    children: ReactNode;
+    missingFields?: string[];
+}
+/**
+ * Default submit button wrapper with tooltip for missing fields
+ */
+declare const DefaultSubmitButtonWrapper: ({ children, missingFields }: SubmitButtonWrapperProps) => string | number | bigint | boolean | import("react/jsx-runtime").JSX.Element | Iterable<ReactNode> | Promise<string | number | bigint | boolean | import('react').ReactPortal | import('react').ReactElement<unknown, string | import('react').JSXElementConstructor<any>> | Iterable<ReactNode> | null | undefined> | null | undefined;
+export default DefaultSubmitButtonWrapper;

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

@@ -0,0 +1,7 @@
+import { UiRenderProps } from '../../../../types/renderer';
+export declare const Divider: ({ node }: UiRenderProps) => import("react/jsx-runtime").JSX.Element;
+export declare const Title: ({ node }: UiRenderProps) => import("react/jsx-runtime").JSX.Element;
+export declare const defaultUI: {
+    divider: ({ node }: UiRenderProps) => import("react/jsx-runtime").JSX.Element;
+    title: ({ node }: UiRenderProps) => import("react/jsx-runtime").JSX.Element;
+};

package/dist/renderer/features/TreegeRenderer/web/components/inputs/DefaultAddressInput.d.ts

@@ -0,0 +1,3 @@
+import { InputRenderProps } from '../../../../../types/renderer';
+declare const DefaultAddressInput: ({ node, value, setValue, error }: InputRenderProps<"address">) => import("react/jsx-runtime").JSX.Element;
+export default DefaultAddressInput;

package/dist/renderer/features/TreegeRenderer/web/components/inputs/DefaultAutocompleteInput.d.ts

@@ -0,0 +1,3 @@
+import { InputRenderProps } from '../../../../../types/renderer';
+declare const DefaultAutocompleteInput: ({ node, value, setValue, error }: InputRenderProps<"autocomplete">) => import("react/jsx-runtime").JSX.Element;
+export default DefaultAutocompleteInput;

package/dist/renderer/features/TreegeRenderer/web/components/inputs/DefaultCheckboxInput.d.ts

@@ -0,0 +1,3 @@
+import { InputRenderProps } from '../../../../../types/renderer';
+declare const DefaultCheckboxInput: ({ node, value, setValue, error }: InputRenderProps<"checkbox">) => import("react/jsx-runtime").JSX.Element;
+export default DefaultCheckboxInput;

package/dist/renderer/features/TreegeRenderer/web/components/inputs/DefaultDateInput.d.ts

@@ -0,0 +1,3 @@
+import { InputRenderProps } from '../../../../../types/renderer';
+declare const DefaultDateInput: ({ node, value, setValue, error }: InputRenderProps<"date">) => import("react/jsx-runtime").JSX.Element;
+export default DefaultDateInput;

package/dist/renderer/features/TreegeRenderer/web/components/inputs/DefaultDateRangeInput.d.ts

@@ -0,0 +1,3 @@
+import { InputRenderProps } from '../../../../../types/renderer';
+declare const DefaultDateRangeInput: ({ node, value, setValue, error }: InputRenderProps<"daterange">) => import("react/jsx-runtime").JSX.Element;
+export default DefaultDateRangeInput;

package/dist/renderer/features/TreegeRenderer/web/components/inputs/DefaultFileInput.d.ts

@@ -0,0 +1,3 @@
+import { InputRenderProps } from '../../../../../types/renderer';
+declare const DefaultFileInput: ({ node, setValue, error }: InputRenderProps<"file">) => import("react/jsx-runtime").JSX.Element;
+export default DefaultFileInput;

package/dist/renderer/features/TreegeRenderer/web/components/inputs/DefaultHiddenInput.d.ts

@@ -0,0 +1,3 @@
+import { InputRenderProps } from '../../../../../types/renderer';
+declare const DefaultHiddenInput: ({ node, value }: InputRenderProps<"hidden">) => import("react/jsx-runtime").JSX.Element;
+export default DefaultHiddenInput;

package/dist/renderer/features/TreegeRenderer/web/components/inputs/DefaultHttpInput.d.ts

@@ -0,0 +1,3 @@
+import { InputRenderProps } from '../../../../../types/renderer';
+declare const DefaultHttpInput: ({ node, value, setValue, error }: InputRenderProps<"http">) => import("react/jsx-runtime").JSX.Element;
+export default DefaultHttpInput;

package/dist/renderer/features/TreegeRenderer/web/components/inputs/DefaultNumberInput.d.ts

@@ -0,0 +1,3 @@
+import { InputRenderProps } from '../../../../../types/renderer';
+declare const DefaultNumberInput: ({ node, value, setValue, error }: InputRenderProps<"number">) => import("react/jsx-runtime").JSX.Element;
+export default DefaultNumberInput;

package/dist/renderer/features/TreegeRenderer/web/components/inputs/DefaultPasswordInput.d.ts

@@ -0,0 +1,3 @@
+import { InputRenderProps } from '../../../../../types/renderer';
+declare const DefaultPasswordInput: ({ node, value, setValue, error }: InputRenderProps<"password">) => import("react/jsx-runtime").JSX.Element;
+export default DefaultPasswordInput;

package/dist/renderer/features/TreegeRenderer/web/components/inputs/DefaultRadioInput.d.ts

@@ -0,0 +1,3 @@
+import { InputRenderProps } from '../../../../../types/renderer';
+declare const DefaultRadioInput: ({ node, value, setValue, error }: InputRenderProps<"radio">) => import("react/jsx-runtime").JSX.Element;
+export default DefaultRadioInput;

package/dist/renderer/features/TreegeRenderer/web/components/inputs/DefaultSelectInput.d.ts

@@ -0,0 +1,3 @@
+import { InputRenderProps } from '../../../../../types/renderer';
+declare const DefaultSelectInput: ({ node, value, setValue, error }: InputRenderProps<"select">) => import("react/jsx-runtime").JSX.Element;
+export default DefaultSelectInput;

package/dist/renderer/features/TreegeRenderer/web/components/inputs/DefaultSwitchInput.d.ts

@@ -0,0 +1,3 @@
+import { InputRenderProps } from '../../../../../types/renderer';
+declare const DefaultSwitchInput: ({ node, value, setValue, error }: InputRenderProps<"switch">) => import("react/jsx-runtime").JSX.Element;
+export default DefaultSwitchInput;

package/dist/renderer/features/TreegeRenderer/web/components/inputs/DefaultTextAreaInput.d.ts

@@ -0,0 +1,3 @@
+import { InputRenderProps } from '../../../../../types/renderer';
+declare const DefaultTextAreaInput: ({ node, value, setValue, error }: InputRenderProps<"textarea">) => import("react/jsx-runtime").JSX.Element;
+export default DefaultTextAreaInput;

package/dist/renderer/features/TreegeRenderer/web/components/inputs/DefaultTextInput.d.ts

@@ -0,0 +1,3 @@
+import { InputRenderProps } from '../../../../../types/renderer';
+declare const DefaultTextInput: ({ node, value, setValue, error }: InputRenderProps<"text">) => import("react/jsx-runtime").JSX.Element;
+export default DefaultTextInput;

package/dist/renderer/features/TreegeRenderer/web/components/inputs/DefaultTimeInput.d.ts

@@ -0,0 +1,3 @@
+import { InputRenderProps } from '../../../../../types/renderer';
+declare const DefaultTimeInput: ({ node, value, setValue, error }: InputRenderProps<"time">) => import("react/jsx-runtime").JSX.Element;
+export default DefaultTimeInput;

package/dist/renderer/features/TreegeRenderer/web/components/inputs/DefaultTimeRangeInput.d.ts

@@ -0,0 +1,3 @@
+import { InputRenderProps } from '../../../../../types/renderer';
+declare const DefaultTimeRangeInput: ({ node, value, setValue, error }: InputRenderProps<"timerange">) => import("react/jsx-runtime").JSX.Element;
+export default DefaultTimeRangeInput;

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

@@ -0,0 +1,24 @@
+/**
+ * Hook for translating text in the renderer with context-aware language preference.
+ *
+ * This hook uses the language from TreegeRendererContext (or explicit override) and delegates to the shared useTranslate hook.
+ *
+ * @param language - Optional language override. If not provided, uses language from context.
+ * @returns A function that translates either a translation key or a Translatable object
+ *
+ * @example
+ * // Static translation (from translation files)
+ * const t = useTranslate();
+ * const errorMsg = t("validation.required"); // "This field is required"
+ *
+ * @example
+ * // Dynamic translation (from node data)
+ * const t = useTranslate();
+ * const label = t(node.data.label); // Translates user-defined content
+ *
+ * @example
+ * // With explicit language
+ * const t = useTranslate("fr");
+ * const errorMsg = t("validation.required"); // "Ce champ est requis"
+ */
+export declare const useTranslate: (language?: string) => (key?: import('../../main').Translatable | import('../../main').TranslationKey | string) => string;

package/dist/renderer/index.d.ts

@@ -0,0 +1,17 @@
+export { TreegeConfigProvider, useTreegeConfig } from './context/TreegeConfigContext';
+export { useTreegeRenderer } from './features/TreegeRenderer/useTreegeRenderer';
+export * from './features/TreegeRenderer/web/components/DefaultFormWrapper';
+export * from './features/TreegeRenderer/web/components/DefaultGroup';
+export * from './features/TreegeRenderer/web/components/DefaultInputs';
+export * from './features/TreegeRenderer/web/components/DefaultSubmitButton';
+export * from './features/TreegeRenderer/web/components/DefaultUI';
+export * from './features/TreegeRenderer/web/TreegeRenderer';
+export { default as TreegeRenderer } from './features/TreegeRenderer/web/TreegeRenderer';
+export type { TreegeRendererConfig } from './types/renderer';
+export * from './types/renderer';
+export * from './utils/conditions';
+export * from './utils/file';
+export * from './utils/flow';
+export * from './utils/form';
+export { ThemeProvider, useTheme } from '../shared/context/ThemeContext';
+export { getTranslatedText } from '../shared/utils/translations';

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

@@ -0,0 +1,187 @@
+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';
+/**
+ * Type mapping for input values based on input type
+ */
+export type InputValueTypeMap = {
+    address: string;
+    autocomplete: string;
+    checkbox: boolean | string[];
+    date: string;
+    daterange: [string, string] | [string | undefined, string | undefined] | null;
+    file: SerializableFile | SerializableFile[] | null;
+    hidden: string;
+    http: string | string[];
+    number: number | null;
+    password: string;
+    radio: string;
+    select: string | string[];
+    switch: boolean;
+    text: string;
+    textarea: string;
+    time: string;
+    timerange: [string, string] | [string | undefined, string | undefined] | null;
+};
+/**
+ * Form values stored during rendering
+ */
+export type FormValues = Record<string, any>;
+/**
+ * Union of all possible input value types
+ */
+export type InputValue = string | number | boolean | string[] | SerializableFile | SerializableFile[] | [string, string] | [string | undefined, string | undefined] | null;
+/**
+ * Props for input components with dynamic value typing
+ * All form state is provided via props for easier custom component implementation
+ */
+export type InputRenderProps<T extends InputType = InputType> = {
+    node: Node<InputNodeData>;
+    /**
+     * Current value of the input field (typed based on input type when T is specified)
+     */
+    value: InputValueTypeMap[T];
+    /**
+     * Function to update the input value
+     * @param value - The new value (typed based on input type when T is specified)
+     */
+    setValue: (value: InputValueTypeMap[T]) => void;
+    /**
+     * Validation error message for this field (if any)
+     */
+    error?: string;
+};
+export type UiRenderProps = {
+    node: Node<UINodeData>;
+};
+/**
+ * Props for UI/Group components (use useTreegeContext for state)
+ */
+export type NodeRenderProps = {
+    node: Node<TreegeNodeData>;
+};
+/**
+ * Type-safe input renderers mapping
+ * Each input type gets its own properly typed InputRenderProps
+ */
+export type InputRenderers = {
+    [K in InputType]?: (props: InputRenderProps<K>) => ReactNode;
+};
+/**
+ * Custom renderer components
+ */
+export type TreegeRendererComponents = {
+    /**
+     * Custom input renderers by input type
+     * Each renderer receives properly typed value and setValue based on the input type
+     */
+    inputs?: InputRenderers;
+    /**
+     * Custom UI node renderers by UI type
+     */
+    ui?: Partial<Record<UIType, (props: NodeRenderProps) => ReactNode>>;
+    /**
+     * Custom group container renderer
+     */
+    group?: (props: NodeRenderProps) => ReactNode;
+    /**
+     * Custom form wrapper
+     */
+    form?: (props: {
+        children: ReactNode;
+        onSubmit: (e: FormEvent) => void;
+    }) => ReactNode;
+    /**
+     * Custom submit button (pure button without wrapper)
+     */
+    submitButton?: (props: {
+        label?: string;
+    }) => ReactNode;
+    /**
+     * Custom submit button wrapper (e.g., for tooltip with missing fields)
+     */
+    submitButtonWrapper?: (props: {
+        children: ReactNode;
+        missingFields?: string[];
+    }) => ReactNode;
+};
+/**
+ * Configuration options that can be set globally via TreegeConfigProvider
+ * or locally via TreegeRenderer config prop
+ */
+export type TreegeRendererConfig = {
+    /**
+     * Custom component renderers
+     */
+    components?: TreegeRendererComponents;
+    /**
+     * Google Maps API key for address autocomplete
+     * If not provided, falls back to free Nominatim (OpenStreetMap)
+     */
+    googleApiKey?: string;
+    /**
+     * Current language for translations
+     * @default "en"
+     */
+    language?: string;
+    /**
+     * Theme for the renderer
+     * @default "dark"
+     */
+    theme?: "dark" | "light";
+    /**
+     * Validation mode
+     * @default "onSubmit"
+     */
+    validationMode?: "onChange" | "onSubmit";
+};
+/**
+ * Props for the TreegeRenderer component
+ */
+export type TreegeRendererProps = {
+    /**
+     * 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
+     */
+    onChange?: (values: FormValues) => void;
+    /**
+     * Callback when form is submitted
+     */
+    onSubmit?: (values: FormValues) => 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/conditions.d.ts

@@ -0,0 +1,14 @@
+import { Node } from '@xyflow/react';
+import { FormValues } from '../types/renderer';
+import { EdgeCondition } from '../../shared/types/edge';
+import { TreegeNodeData } from '../../shared/types/node';
+/**
+ * Evaluates a single condition against form values
+ * Note: The field parameter can be either a field name OR a node ID
+ */
+export declare const evaluateCondition: (condition: EdgeCondition, formValues: FormValues, nodeMap?: Map<string, Node<TreegeNodeData>>) => boolean;
+/**
+ * Evaluates multiple conditions with logical operators (AND/OR)
+ * Returns true if all conditions are met according to their logical operators
+ */
+export declare const evaluateConditions: (conditions: EdgeCondition[] | undefined, formValues: FormValues, nodeMap?: Map<string, Node<TreegeNodeData>>) => boolean;

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

@@ -0,0 +1,22 @@
+/**
+ * Represents a serializable file object with base64 data
+ */
+export interface SerializableFile {
+    name: string;
+    size: number;
+    type: string;
+    lastModified: number;
+    data: string;
+}
+/**
+ * Converts a File object to a serializable format with base64 data
+ */
+export declare const fileToSerializable: (file: File) => Promise<SerializableFile>;
+/**
+ * Converts a SerializableFile back to a File object
+ */
+export declare const serializableToFile: (serializable: SerializableFile) => File;
+/**
+ * Converts multiple File objects to serializable format
+ */
+export declare const filesToSerializable: (files: File[]) => Promise<SerializableFile[]>;