treege 3.0.0-beta.81 → 3.0.0-beta.83

package/dist/editor.js

@@ -1,3 +1,3 @@
-import { t as e } from "./editor-h20-TVM8.js";
-import { n as t, t as n } from "./ThemeContext-BgTIhoK6.js";
+import { t as e } from "./editor-CbcW0OVV.js";
+import { n as t, t as n } from "./ThemeContext-BnPOFQC7.js";
 export { n as ThemeProvider, e as TreegeEditor, t as useTheme };

package/dist/main.js

@@ -1,6 +1,6 @@
-import { t as e } from "./editor-h20-TVM8.js";
-import { F as t, G as n, H as r, P as i, U as a, V as o, W as s, _ as c, a as l, c as u, g as d, h as f, i as p, l as m, m as h, n as g, o as _, r as v, s as y, t as b, v as x } from "./ThemeContext-BgTIhoK6.js";
-import { C as S, L as C, S as w, _ as T, a as E, b as D, c as O, d as k, g as A, h as j, i as M, m as N, n as P, o as F, r as I, u as L, v as R, x as z, y as B } from "./DefaultSubmitButton-Dg9GPvh-.js";
-import { a as V, c as H, i as U, l as W, n as G, o as K, r as q, s as J } from "./useRenderNode-B1sfwbia.js";
-import { i as Y, n as X, r as Z, t as Q } from "./renderer-DI6nF4St.js";
-export { S as DefaultAddressInput, w as DefaultAutocompleteInput, z as DefaultCheckboxInput, D as DefaultDateInput, B as DefaultDateRangeInput, R as DefaultFileInput, T as DefaultHiddenInput, A as DefaultHttpInput, C as DefaultInputLabel, j as DefaultNumberInput, N as DefaultPasswordInput, k as DefaultRadioInput, L as DefaultSelectInput, O as DefaultSwitchInput, F as DefaultTextAreaInput, E as DefaultTextInput, M as DefaultTimeInput, I as DefaultTimeRangeInput, X as Divider, b as ThemeProvider, Z as Title, e as TreegeEditor, Q as TreegeRenderer, H as TreegeRendererProvider, v as applyReferenceTransformation, p as buildInitialFormValues, l as calculateReferenceFieldUpdates, _ as checkFormFieldHasValue, y as convertFormValuesToNamedFormat, P as defaultInputRenderers, Y as defaultUI, K as evaluateCondition, J as evaluateConditions, h as fileToSerializable, f as filesToSerializable, q as findStartNode, d as formatFileSize, U as getFlowRenderState, o as getStaticTranslations, r as getTranslatedText, u as isFieldEmpty, a as isGroupNode, s as isInputNode, V as isStartNode, n as isUINode, c as normalizeSerializableFiles, m as resolveNodeDefaultValue, i as sanitize, t as sanitizeHttpResponse, x as serializableToFile, g as useTheme, G as useTreegeRenderer, W as useTreegeRendererConfig };
+import { t as e } from "./editor-CbcW0OVV.js";
+import { G as t, I as n, J as r, K as i, L as a, U as o, W as s, Y as c, _ as l, a as u, b as d, c as f, g as p, h as m, i as h, l as g, m as _, n as v, o as y, q as b, r as x, s as S, t as C, v as w, y as T } from "./ThemeContext-BnPOFQC7.js";
+import { C as E, L as D, S as O, _ as k, a as A, b as j, c as M, d as N, g as P, h as F, i as I, m as L, n as R, o as z, r as B, u as V, v as H, x as U, y as W } from "./DefaultSubmitButton-DpeL3OxC.js";
+import { a as G, c as K, i as q, l as J, n as Y, o as X, r as Z, s as Q } from "./useRenderNode-DQ5lvXuj.js";
+import { a as $, i as ee, n as te, o as ne, r as re, s as ie, t as ae } from "./renderer-KRzuU6OD.js";
+export { E as DefaultAddressInput, O as DefaultAutocompleteInput, U as DefaultCheckboxInput, j as DefaultDateInput, W as DefaultDateRangeInput, H as DefaultFileInput, k as DefaultHiddenInput, P as DefaultHttpInput, D as DefaultInputLabel, F as DefaultNumberInput, L as DefaultPasswordInput, N as DefaultRadioInput, V as DefaultSelectInput, M as DefaultSwitchInput, z as DefaultTextAreaInput, A as DefaultTextInput, I as DefaultTimeInput, B as DefaultTimeRangeInput, $ as Divider, C as ThemeProvider, ne as Title, e as TreegeEditor, ee as TreegeRenderer, K as TreegeRendererProvider, ae as TreegeViewer, x as applyReferenceTransformation, h as buildInitialFormValues, u as calculateReferenceFieldUpdates, y as checkFormFieldHasValue, S as convertFormValuesToNamedFormat, R as defaultInputRenderers, ie as defaultUI, X as evaluateCondition, Q as evaluateConditions, _ as fileNameFromUrl, m as fileToSerializable, p as filesToSerializable, Z as findStartNode, l as formatFileSize, q as getFlowRenderState, o as getStaticTranslations, s as getTranslatableValue, t as getTranslatedText, te as getViewerFields, f as isFieldEmpty, b as isGroupNode, re as isImageFile, r as isInputNode, w as isRemoteFileData, G as isStartNode, c as isUINode, T as normalizeSerializableFiles, g as resolveNodeDefaultValue, n as sanitize, a as sanitizeHttpResponse, d as serializableToFile, i as setTranslatableValue, v as useTheme, Y as useTreegeRenderer, J as useTreegeRendererConfig };

package/dist/renderer/features/TreegeViewer/utils/viewerFields.d.ts

@@ -0,0 +1,78 @@
+import { Node } from '@xyflow/react';
+import { FormValues } from '../../../types/renderer';
+import { SerializableFile } from '../../../../shared/types/file';
+import { Flow, InputNodeData, InputType } from '../../../../shared/types/node';
+/**
+ * Display-ready representation of a submitted field value, normalized per input
+ * type so a viewer can render it without re-deriving formatting rules:
+ * - `text`    free-form string (text, number, date, ranges, resolved option label…)
+ * - `boolean` a yes/no value (switch) — render as a read-only toggle/checkbox
+ * - `tags`    a list of labels (multi-select checkbox) — render as chips
+ * - `files`   uploaded documents — render names or thumbnails (often overridden)
+ * - `empty`   no value was submitted for this field
+ */
+export type ViewerFieldDisplay = {
+    kind: "text";
+    text: string;
+} | {
+    kind: "boolean";
+    checked: boolean;
+} | {
+    kind: "tags";
+    tags: string[];
+} | {
+    kind: "files";
+    files: SerializableFile[];
+} | {
+    kind: "empty";
+};
+/** A single resolved field of a submitted form, ready for read-only rendering. */
+export interface ViewerField {
+    /** The flow node id. */
+    id: string;
+    /** The submission key (name > translated label > id), as used in `onSubmit`. */
+    name: string;
+    /** The input type (`text`, `select`, `daterange`, `file`, …). */
+    type: InputType;
+    /** The translated field label (falls back to `name`, then node id). */
+    label: string;
+    /** The raw submitted value, untouched. */
+    rawValue: unknown;
+    /** Normalized, render-ready representation of the value. */
+    display: ViewerFieldDisplay;
+    /** The originating flow node (escape hatch for custom rendering). */
+    node: Node<InputNodeData>;
+}
+export interface GetViewerFieldsOptions {
+    /** Language used to resolve translatable labels/options (defaults to `en`). */
+    language?: string;
+    /**
+     * Base URL used to resolve relative file paths (e.g. `uploads/x.png`) into
+     * absolute URLs — same role as on `TreegeRenderer`/`TreegeEditor`. Absolute,
+     * `data:` and `blob:` URLs are left untouched.
+     */
+    baseUrl?: string;
+}
+/**
+ * Whether a file should be previewed inline as an image — detected by MIME type
+ * (`image/*`), a `data:image/` data-URL, or a recognized image URL extension.
+ */
+export declare const isImageFile: (file: SerializableFile) => boolean;
+/**
+ * Resolve a submitted form into a flat, render-ready list of fields.
+ *
+ * Mirrors what the renderer would show for the same values: the submission is
+ * normalized to node-id keys (accepting both `name`- and `id`-keyed input, like
+ * `initialValues`), then run through the same branch-visibility logic so only
+ * the fields that were actually reachable for these values are returned —
+ * inactive branches and `hidden`/`submit` nodes are excluded.
+ *
+ * This is the headless core behind {@link TreegeViewer}: consumers wanting a
+ * custom layout can render straight from this list.
+ *
+ * @param flow - The flow definition the values were submitted against
+ * @param values - The submitted values (`name`- or `id`-keyed)
+ * @param options - Resolution options (language, baseUrl)
+ * @returns The ordered, visible, display-ready fields
+ */
+export declare const getViewerFields: (flow: Flow | null | undefined, values: FormValues | null | undefined, options?: GetViewerFieldsOptions) => ViewerField[];

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

@@ -0,0 +1,70 @@
+import { ReactNode } from 'react';
+import { ViewerField } from '../utils/viewerFields';
+import { FormValues } from '../../../types/renderer';
+import { Flow, InputType } from '../../../../shared/types/node';
+/** Per-type override map: `{ file: (field) => <Thumbnails /> }`. */
+export type ViewerFieldRenderers = Partial<Record<InputType, (field: ViewerField) => ReactNode>>;
+export interface TreegeViewerProps {
+    /**
+     * The flow the values were submitted against
+     */
+    flow: Flow;
+    /**
+     * The submitted values (`name`- or `id`-keyed, e.g. the `onSubmit` payload).
+     */
+    values: FormValues;
+    /**
+     *  Language used to resolve translatable labels/options (defaults to `en`).
+     */
+    language?: string;
+    /**
+     * Base URL used to resolve relative file paths into absolute URLs — same role
+     * as on `TreegeRenderer`/`TreegeEditor`. `data:`/`blob:`/absolute URLs are
+     * left untouched.
+     */
+    baseUrl?: string;
+    /**
+     * Field names (or ids) to hide from the view.
+     */
+    excludedFields?: string[];
+    /**
+     * Text shown when a field has no submitted value (defaults to `"—"`).
+     */
+    emptyText?: string;
+    /**
+     * Extra class names on the root element. *
+     */
+    className?: string;
+    /**
+     * Per-type rendering overrides for the value cell. Use this for app-specific
+     * cases — typically `file` (e.g. render thumbnails from your own storage)
+     * while every other type keeps its built-in rendering.
+     */
+    renderField?: ViewerFieldRenderers;
+    /**
+     * Wrap or replace a whole field row (label + value). Receives the resolved
+     * field and the default row node; return your own layout or the default.
+     */
+    renderRow?: (field: ViewerField, defaultRow: ReactNode) => ReactNode;
+}
+/**
+ * Read-only viewer for a submitted Treege form. Given the `flow` and the
+ * submitted `values`, it renders every reachable field as a label/value pair —
+ * resolving option labels, formatting dates/ranges and i18n labels the same way
+ * the renderer does, scoped to the active branch.
+ *
+ * Styling matches the renderer (shadcn/Tailwind, `tg:` prefix). For values that
+ * need app-specific rendering (chiefly uploaded `file`s) pass `renderField`; to
+ * change the whole row layout pass `renderRow`.
+ *
+ * @example
+ * <TreegeViewer
+ *   flow={flow}
+ *   values={submitted}
+ *   language="fr"
+ *   excludedFields={["internalNote"]}
+ *   renderField={{ file: ({ rawValue }) => <Thumbnails files={rawValue} /> }}
+ * />
+ */
+declare const TreegeViewer: ({ flow, values, baseUrl, excludedFields, className, renderField, renderRow, emptyText, language, }: TreegeViewerProps) => import("react/jsx-runtime").JSX.Element;
+export default TreegeViewer;

package/dist/renderer/index.d.ts

@@ -9,6 +9,9 @@ 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 * from './features/TreegeViewer/utils/viewerFields';
+export * from './features/TreegeViewer/web/TreegeViewer';
+export { default as TreegeViewer } from './features/TreegeViewer/web/TreegeViewer';
 export type { TreegeRendererConfig } from './types/renderer';
 export * from './types/renderer';
 export * from './utils/conditions';

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

@@ -12,11 +12,24 @@ export declare const serializableToFile: (serializable: SerializableFile) => Fil
  * Converts multiple File objects to serializable format
  */
 export declare const filesToSerializable: (files: File[]) => Promise<SerializableFile[]>;
+/**
+ * Derive a readable file name from a URL's last path segment (query/hash stripped).
+ */
+export declare const fileNameFromUrl: (url: string) => string;
+/**
+ * Whether a file's `data` is a URL to fetch/link to (an http(s) or relative
+ * path) rather than inline base64/blob content. Useful to decide whether to
+ * render the file as a clickable link or resolve it against a base URL.
+ */
+export declare const isRemoteFileData: (data: string | null | undefined) => boolean;
 /**
  * Normalizes a file field value into an array of `SerializableFile`.
- * Handles single file, array of files, and empty (`null`/`undefined`) values.
+ * Handles a single file, an array, and empty (`null`/`undefined`) values. A
+ * stored document may also be referenced by a bare URL string (or an array
+ * containing some) — those are coerced into a `SerializableFile` whose `data`
+ * holds the URL and whose `name` is derived from it.
  */
-export declare const normalizeSerializableFiles: (value: SerializableFile | SerializableFile[] | null | undefined) => SerializableFile[];
+export declare const normalizeSerializableFiles: (value: SerializableFile | string | Array<SerializableFile | string> | null | undefined) => SerializableFile[];
 /**
  * Formats a byte size into a human-readable string (B / KB / MB)
  */