treege 3.0.0-beta.62 → 3.0.0-beta.63

package/dist/editor.js

@@ -1,3 +1,3 @@
-import { t as e } from "./editor-K1jjfc5n.js";
-import { n as t, t as n } from "./ThemeContext-cGSTk24y.js";
+import { t as e } from "./editor-Bag5U_S5.js";
+import { n as t, t as n } from "./ThemeContext-nopV_oRU.js";
 export { n as ThemeProvider, e as TreegeEditor, t as useTheme };

package/dist/main.js

@@ -1,4 +1,4 @@
-import { t as e } from "./editor-K1jjfc5n.js";
-import { B as t, H as n, M as r, U as i, V as a, a as o, b as s, c, d as l, f as u, g as d, h as f, i as p, j as m, l as h, m as g, n as _, o as v, p as y, s as b, t as x, u as S, x as C, y as w, z as T } from "./ThemeContext-cGSTk24y.js";
-import { C as E, E as D, S as O, T as k, _ as A, a as j, b as M, d as N, f as P, i as F, l as I, m as L, n as R, p as z, r as B, s as V, t as H, u as U, v as W, w as G, x as K, y as q } from "./DefaultInputs-DamDWb5R.js";
-export { D as DefaultAddressInput, k as DefaultAutocompleteInput, G as DefaultCheckboxInput, E as DefaultDateInput, O as DefaultDateRangeInput, K as DefaultFileInput, M as DefaultHiddenInput, q as DefaultHttpInput, W as DefaultNumberInput, A as DefaultPasswordInput, L as DefaultRadioInput, z as DefaultSelectInput, V as DefaultSwitchInput, j as DefaultTextAreaInput, F as DefaultTextInput, B as DefaultTimeInput, R as DefaultTimeRangeInput, U as Divider, x as ThemeProvider, N as Title, e as TreegeEditor, I as TreegeRenderer, S as TreegeRendererProvider, u as applyReferenceTransformation, y as calculateReferenceFieldUpdates, g as checkFormFieldHasValue, f as convertFormValuesToNamedFormat, H as defaultInputRenderers, P as defaultUI, c as evaluateCondition, h as evaluateConditions, w as fileToSerializable, s as filesToSerializable, o as findStartNode, v as getFlowRenderState, T as getStaticTranslations, t as getTranslatedText, d as isFieldEmpty, a as isGroupNode, n as isInputNode, b as isStartNode, i as isUINode, m as sanitize, r as sanitizeHttpResponse, C as serializableToFile, _ as useTheme, p as useTreegeRenderer, l as useTreegeRendererConfig };
+import { t as e } from "./editor-Bag5U_S5.js";
+import { B as t, H as n, M as r, N as i, S as a, U as o, V as s, W as c, _ as l, a as u, b as d, c as f, d as p, f as m, g as h, h as g, i as _, l as v, m as y, n as b, o as x, p as S, s as C, t as w, u as T, x as E } from "./ThemeContext-nopV_oRU.js";
+import { C as D, E as O, S as k, T as A, _ as j, a as M, b as N, d as P, f as F, i as I, l as L, m as R, n as z, p as B, r as V, s as H, t as U, u as W, v as G, w as K, x as q, y as J } from "./DefaultInputs-nX-CVK2i.js";
+export { O as DefaultAddressInput, A as DefaultAutocompleteInput, K as DefaultCheckboxInput, D as DefaultDateInput, k as DefaultDateRangeInput, q as DefaultFileInput, N as DefaultHiddenInput, J as DefaultHttpInput, G as DefaultNumberInput, j as DefaultPasswordInput, R as DefaultRadioInput, B as DefaultSelectInput, H as DefaultSwitchInput, M as DefaultTextAreaInput, I as DefaultTextInput, V as DefaultTimeInput, z as DefaultTimeRangeInput, W as Divider, w as ThemeProvider, P as Title, e as TreegeEditor, L as TreegeRenderer, T as TreegeRendererProvider, m as applyReferenceTransformation, S as buildInitialFormValues, y as calculateReferenceFieldUpdates, g as checkFormFieldHasValue, h as convertFormValuesToNamedFormat, U as defaultInputRenderers, F as defaultUI, f as evaluateCondition, v as evaluateConditions, d as fileToSerializable, E as filesToSerializable, u as findStartNode, x as getFlowRenderState, t as getStaticTranslations, s as getTranslatedText, l as isFieldEmpty, n as isGroupNode, o as isInputNode, C as isStartNode, c as isUINode, r as sanitize, i as sanitizeHttpResponse, a as serializableToFile, b as useTheme, _ as useTreegeRenderer, p as useTreegeRendererConfig };

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

@@ -6,7 +6,7 @@ import { TreegeRendererProps } from '../../../types/renderer';
  * - Omits className (not used in React Native)
  * - Adds style and contentContainerStyle (React Native specific)
  */
-export type TreegeRendererNativeProps = Omit<TreegeRendererProps, "className"> & {
+export type TreegeRendererNativeProps = Omit<TreegeRendererProps, "className" | "formId"> & {
     /**
      * Style for the ScrollView container
      */

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

@@ -1,3 +1,3 @@
 import { StepRenderProps } from '../../../../types/renderer';
-declare const DefaultStep: ({ label, children, isFirstStep, isLastStep, canContinue, isSubmitting, onBack, onContinue }: StepRenderProps) => import("react/jsx-runtime").JSX.Element;
+declare const DefaultStep: ({ label, children, canGoBack, isLastStep, canContinue, isSubmitting, onBack, onContinue }: StepRenderProps) => import("react/jsx-runtime").JSX.Element;
 export default DefaultStep;

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

@@ -28,6 +28,7 @@ export declare const useTreegeRenderer: ({ baseUrl, components, flow, googleApiK
         components: {
             form: ((props: {
                 children: import('react').ReactNode;
+                id?: string;
                 onSubmit: (e: import('react').FormEvent<HTMLFormElement>) => void;
             }) => import('react').ReactNode) | undefined;
             inputs: {
@@ -55,6 +56,7 @@ export declare const useTreegeRenderer: ({ baseUrl, components, flow, googleApiK
             submitButton: ((props: {
                 label?: string;
                 disabled?: boolean;
+                isSubmitting?: boolean;
                 [key: string]: unknown;
             } | {
                 children?: import('react').ReactNode;

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

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

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

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

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

@@ -1,3 +1,3 @@
 import { StepRenderProps } from '../../../../types/renderer';
-declare const DefaultStep: ({ label, children, isFirstStep, isLastStep, canContinue, isSubmitting, onBack, onContinue, missingFields, }: StepRenderProps) => import("react/jsx-runtime").JSX.Element;
+declare const DefaultStep: ({ label, children, canGoBack, isLastStep, canContinue, isSubmitting, onBack, onContinue, missingFields, }: StepRenderProps) => import("react/jsx-runtime").JSX.Element;
 export default DefaultStep;

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

@@ -1,6 +1,10 @@
 import { ButtonHTMLAttributes } from 'react';
 export interface SubmitButtonProps extends ButtonHTMLAttributes<HTMLButtonElement> {
     label?: string;
+    /**
+     * When true, shows a spinner inside the button (and keeps it disabled).
+     */
+    isSubmitting?: boolean;
 }
 /**
  * Default submit button

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

@@ -20,6 +20,7 @@ type UseRenderNodeParams = {
     formErrors: Record<string, string>;
     formValues: FormValues;
     inputNodes: Node<InputNodeData>[];
+    isSubmitting?: boolean;
     missingRequiredFields: string[];
     setFieldValue: (fieldId: string, value: unknown) => void;
 };
@@ -33,15 +34,17 @@ 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, DefaultInputWrapper, DefaultSubmitButton, DefaultSubmitButtonWrapper, config, defaultInputRenderers, defaultUI, formErrors, formValues, inputNodes, missingRequiredFields, setFieldValue, }: UseRenderNodeParams) => {
+export declare const useRenderNode: ({ DefaultFormWrapper, DefaultInputWrapper, DefaultSubmitButton, DefaultSubmitButtonWrapper, config, defaultInputRenderers, defaultUI, formErrors, formValues, inputNodes, isSubmitting, missingRequiredFields, setFieldValue, }: UseRenderNodeParams) => {
     FormWrapper: ((props: {
         children: ReactNode;
+        id?: string;
         onSubmit: (e: import('react').FormEvent<HTMLFormElement>) => void;
     }) => ReactNode) | AnyComponent;
     renderNode: (node: Node<TreegeNodeData>) => ReactNode;
     SubmitButton: ((props: {
         label?: string;
         disabled?: boolean;
+        isSubmitting?: boolean;
         [key: string]: unknown;
     } | {
         children?: ReactNode;

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

@@ -180,6 +180,13 @@ export type StepRenderProps = {
     totalSteps: number;
     /** True when this is the first step (Back should be hidden/disabled). */
     isFirstStep: boolean;
+    /**
+     * Whether a Back button should be shown. True on any step past the first, and
+     * also on the first step when the consumer passes an `onBack` prop (to bridge
+     * back-navigation to an outer flow, e.g. a parent modal's steps). Prefer this
+     * over `isFirstStep` to decide whether to render the Back control.
+     */
+    canGoBack: boolean;
     /**
      * True when this is the last visible step. The renderer turns Continue
      * into a submit action on the last step.
@@ -194,7 +201,11 @@ export type StepRenderProps = {
     missingFields?: string[];
     /** Submission in progress (passed through from `useTreegeRenderer`). */
     isSubmitting?: boolean;
-    /** Advance to the previous step. No-op on the first step. */
+    /**
+     * Go back: advances to the previous step, or — on the first step, when the
+     * consumer passed an `onBack` prop — invokes that callback instead. No-op on
+     * the first step when no `onBack` prop was provided.
+     */
     onBack: () => void;
     /**
      * Advance to the next step (or trigger submit on the last step). The wrapper
@@ -226,20 +237,24 @@ export type TreegeRendererComponents = {
      */
     step?: (props: StepRenderProps) => ReactNode;
     /**
-     * Custom form wrapper
+     * Custom form wrapper. `id` (when provided via the `formId` prop) should be
+     * forwarded to the underlying `<form>` element to keep external submit
+     * buttons working.
      */
     form?: (props: {
         children: ReactNode;
+        id?: string;
         onSubmit: (e: FormEvent<HTMLFormElement>) => void;
     }) => ReactNode;
     /**
      * Custom submit button (supports both web and native variants)
-     * Web variant: { label?: string; disabled?: boolean; ...otherHTMLAttributes }
+     * Web variant: { label?: string; disabled?: boolean; isSubmitting?: boolean; ...otherHTMLAttributes }
      * Native variant: { children?: ReactNode; disabled?: boolean; isSubmitting?: boolean; onPress?: () => void }
      */
     submitButton?: (props: {
         label?: string;
         disabled?: boolean;
+        isSubmitting?: boolean;
         [key: string]: unknown;
     } | {
         children?: ReactNode;
@@ -332,7 +347,23 @@ export interface TreegeRendererProps extends TreegeRendererConfig {
      */
     flow?: Flow | null;
     /**
-     * Initial form values
+     * Sets the `id` attribute on the underlying `<form>` element, so a submit
+     * button rendered outside the renderer can target it via the native HTML
+     * `form` attribute: `<button type="submit" form={formId}>`. Web only.
+     */
+    formId?: string;
+    /**
+     * Initial form values — use this to pre-fill the form when editing a record
+     * that was already submitted.
+     *
+     * Keys can be either `node.id` OR the same name-based keys you receive back in
+     * `onChange` / `onSubmit`, so the previously-submitted object can be fed
+     * straight back in without any remapping.
+     *
+     * Reactive: if this changes after mount (e.g. an async-fetched record resolves
+     * later), the form is re-seeded automatically. A new object literal of
+     * identical content does NOT reset the form, so in-progress user edits are
+     * preserved.
      */
     initialValues?: FormValues;
     /**
@@ -340,6 +371,21 @@ export interface TreegeRendererProps extends TreegeRendererConfig {
      * the flow is being fetched. Customizable via `components.loadingSkeleton`.
      */
     isLoading?: boolean;
+    /**
+     * When true, forces the submit/continue button into its loading state
+     * (spinner + disabled). Use this to keep the button busy while an async
+     * `onSubmit` is still resolving on the consumer side. It is OR-ed with the
+     * renderer's own internal submitting state, so it only ever adds to it.
+     */
+    isSubmitting?: boolean;
+    /**
+     * Called when the user clicks Back on the FIRST step. Provide this to bridge
+     * back-navigation to an outer flow (e.g. a parent modal's steps): when set, a
+     * Back button is shown on the first step and triggers this callback instead
+     * of being a no-op. Has no effect on later steps, which always navigate back
+     * internally.
+     */
+    onBack?: () => void;
     /**
      * Callback when form values change
      */

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

@@ -17,6 +17,22 @@ export declare const isFieldEmpty: (value: unknown) => boolean;
  * @returns True if the field has been filled (any value except undefined/null), false otherwise
  */
 export declare const checkFormFieldHasValue: (fieldName: string | undefined, formValues: FormValues) => boolean;
+/**
+ * Build the initial (nodeId-keyed) form state from consumer-provided values.
+ *
+ * Consumers can pass `initialValues` keyed either by `node.id` OR by the same
+ * key shape they receive back in `onChange`/`onSubmit` (resolved via
+ * `resolveNodeKey`: name > label > node.id). This lets an edit screen feed the
+ * previously-submitted object straight back in without any remapping.
+ *
+ * After normalizing provided values, node `defaultValue`s (static / reference)
+ * are applied to any field still left unset — matching a fresh mount.
+ *
+ * @param initialValues - Values provided by the consumer (id- or name-keyed)
+ * @param inputNodes - All input nodes of the flow
+ * @returns Form values keyed strictly by node id
+ */
+export declare const buildInitialFormValues: (initialValues: FormValues, inputNodes: Node<InputNodeData>[]) => FormValues;
 /**
  * Convert internal form values (keyed by nodeId) to external format (keyed by name)
  * When multiple nodes share the same name, later values overwrite earlier ones