hazo_collab_forms 5.7.0 → 6.0.0

package/dist/components/field_audit/auditor.js

@@ -0,0 +1,91 @@
+/**
+ * FormDataAuditor — invisible component that diffs `form_data` between
+ * renders and records each changed field as a `manual` audit entry.
+ *
+ * Coalescing strategy: controlled inputs fire on every keystroke, which
+ * would produce one audit entry per character. Instead, we debounce per
+ * field — when a field changes we (re)start a per-field timer, and once
+ * the user has been idle for `debounce_ms` we record ONE entry whose
+ * `prev_value` is the last committed value and whose `new_value` is the
+ * latest current value. The result is one entry per typing burst.
+ *
+ * On unmount any pending timers are flushed so we don't lose unfinished
+ * edits. Internal keys prefixed with `__` (file attachments,
+ * clarification storage, etc.) are ignored.
+ *
+ * Renders nothing.
+ */
+'use client';
+import { useEffect, useRef } from 'react';
+import { useFieldAuditOptional } from './context.js';
+export function FormDataAuditor({ form_data, current_user, debounce_ms = 750, }) {
+    const audit = useFieldAuditOptional();
+    // Last committed values — what we'll use as `prev_value` when the next
+    // debounced entry fires. Starts at the initial form_data so we don't
+    // emit a synthetic "everything changed" entry on first mount.
+    const committed_ref = useRef({ ...(form_data ?? {}) });
+    // Live form_data, kept fresh via render so the debounced timer reads
+    // the latest value at fire time (not the value at the time we set the timer).
+    const live_ref = useRef(form_data ?? {});
+    live_ref.current = form_data ?? {};
+    // Per-field debounce state. `current_user` is captured into the closure.
+    const pending_ref = useRef(new Map());
+    // Diff each render and schedule audit entries.
+    useEffect(() => {
+        if (!audit)
+            return;
+        const prev = committed_ref.current;
+        const curr = form_data ?? {};
+        const pending = pending_ref.current;
+        const keys = new Set([...Object.keys(prev), ...Object.keys(curr)]);
+        for (const key of keys) {
+            if (key.startsWith('__'))
+                continue;
+            const baseline = pending.get(key)?.baseline ?? prev[key];
+            const after = curr[key];
+            // If the value is back at the baseline (e.g. user typed then erased),
+            // cancel any pending entry and forget the field.
+            if (Object.is(baseline, after)) {
+                const existing = pending.get(key);
+                if (existing) {
+                    clearTimeout(existing.timer);
+                    pending.delete(key);
+                }
+                continue;
+            }
+            // Restart the per-field debounce.
+            const existing = pending.get(key);
+            if (existing) {
+                clearTimeout(existing.timer);
+            }
+            const timer = setTimeout(() => {
+                const latest = live_ref.current[key];
+                const prev_value = pending.get(key)?.baseline ?? prev[key];
+                pending.delete(key);
+                if (Object.is(prev_value, latest))
+                    return;
+                audit.record_change({
+                    field_id: key,
+                    source: 'manual',
+                    prev_value,
+                    new_value: latest,
+                    user: current_user,
+                });
+                committed_ref.current = { ...committed_ref.current, [key]: latest };
+            }, debounce_ms);
+            pending.set(key, { baseline, timer });
+        }
+    }, [form_data, audit, current_user, debounce_ms]);
+    // Flush any pending timers on unmount.
+    useEffect(() => {
+        return () => {
+            const pending = pending_ref.current;
+            for (const [, entry] of pending) {
+                clearTimeout(entry.timer);
+            }
+            pending.clear();
+        };
+    }, []);
+    return null;
+}
+//# sourceMappingURL=auditor.js.map

package/dist/components/field_audit/auditor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"auditor.js","sourceRoot":"","sources":["../../../src/components/field_audit/auditor.tsx"],"names":[],"mappings":"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"}

package/dist/components/field_audit/context.d.ts

@@ -0,0 +1,29 @@
+/**
+ * FieldAuditProvider — owns the in-session audit history.
+ *
+ * State lives in React state, so it dies with the component tree. Persistence
+ * is intentionally out of scope for this release; consuming apps that need
+ * durable audit logs can keep their own copy by subscribing to record_change
+ * via the imperative API.
+ */
+import React from 'react';
+import type { ReactNode } from 'react';
+import type { FieldAuditContextValue } from './types.js';
+declare const FieldAuditContext: React.Context<FieldAuditContextValue | undefined>;
+/**
+ * Hook for consumers that *must* run inside a provider. Throws otherwise.
+ */
+export declare function useFieldAudit(): FieldAuditContextValue;
+/**
+ * Hook for components that may render with or without an audit provider.
+ * `FieldAuditIcon` and `FieldAuditPanel` use this so they can be dropped
+ * into a slot whether or not audit is enabled — when no provider is mounted
+ * they silently render nothing.
+ */
+export declare function useFieldAuditOptional(): FieldAuditContextValue | undefined;
+export interface FieldAuditProviderProps {
+    children: ReactNode;
+}
+export declare function FieldAuditProvider({ children }: FieldAuditProviderProps): import("react/jsx-runtime").JSX.Element;
+export { FieldAuditContext };
+//# sourceMappingURL=context.d.ts.map

package/dist/components/field_audit/context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../../src/components/field_audit/context.tsx"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,OAAO,KAON,MAAM,OAAO,CAAC;AACf,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AACvC,OAAO,KAAK,EAEV,sBAAsB,EAEvB,MAAM,YAAY,CAAC;AAEpB,QAAA,MAAM,iBAAiB,mDAEtB,CAAC;AAEF;;GAEG;AACH,wBAAgB,aAAa,IAAI,sBAAsB,CAMtD;AAED;;;;;GAKG;AACH,wBAAgB,qBAAqB,IAAI,sBAAsB,GAAG,SAAS,CAE1E;AAED,MAAM,WAAW,uBAAuB;IACtC,QAAQ,EAAE,SAAS,CAAC;CACrB;AAMD,wBAAgB,kBAAkB,CAAC,EAAE,QAAQ,EAAE,EAAE,uBAAuB,2CAuGvE;AAED,OAAO,EAAE,iBAAiB,EAAE,CAAC"}

package/dist/components/field_audit/context.js

@@ -0,0 +1,123 @@
+/**
+ * FieldAuditProvider — owns the in-session audit history.
+ *
+ * State lives in React state, so it dies with the component tree. Persistence
+ * is intentionally out of scope for this release; consuming apps that need
+ * durable audit logs can keep their own copy by subscribing to record_change
+ * via the imperative API.
+ */
+'use client';
+import { jsx as _jsx } from "react/jsx-runtime";
+import { createContext, useCallback, useContext, useMemo, useRef, useState, } from 'react';
+const FieldAuditContext = createContext(undefined);
+/**
+ * Hook for consumers that *must* run inside a provider. Throws otherwise.
+ */
+export function useFieldAudit() {
+    const ctx = useContext(FieldAuditContext);
+    if (!ctx) {
+        throw new Error('useFieldAudit must be used inside <FieldAuditProvider>');
+    }
+    return ctx;
+}
+/**
+ * Hook for components that may render with or without an audit provider.
+ * `FieldAuditIcon` and `FieldAuditPanel` use this so they can be dropped
+ * into a slot whether or not audit is enabled — when no provider is mounted
+ * they silently render nothing.
+ */
+export function useFieldAuditOptional() {
+    return useContext(FieldAuditContext);
+}
+function make_id(field_id) {
+    return `${field_id}_${Date.now()}_${Math.random().toString(36).slice(2, 8)}`;
+}
+export function FieldAuditProvider({ children }) {
+    const [entries, set_entries] = useState(() => new Map());
+    const [expanded, set_expanded] = useState(() => new Set());
+    // Mirror entries in a ref so the auto-watcher (FormDataAuditor) can read
+    // the live state without re-binding to setState and creating stale closures.
+    const entries_ref = useRef(entries);
+    entries_ref.current = entries;
+    const record_change = useCallback((input) => {
+        set_entries((prev) => {
+            const existing = prev.get(input.field_id) ?? [];
+            const last = existing[0];
+            const window_ms = input.dedup_window_ms ?? 500;
+            // Dedup against a recent entry with the same new value.
+            if (last &&
+                Object.is(last.new_value, input.new_value) &&
+                Date.now() - last.at < window_ms) {
+                // The auto-watcher fires `manual` on every form_data change; an
+                // explicit caller may classify the same change as `clarification`
+                // before/around the watcher fires. Always promote the existing
+                // entry to the more specific source.
+                if (last.source === 'manual' && input.source !== 'manual') {
+                    const promoted = {
+                        ...last,
+                        source: input.source,
+                        user: input.user ?? last.user,
+                    };
+                    const next = new Map(prev);
+                    next.set(input.field_id, [promoted, ...existing.slice(1)]);
+                    return next;
+                }
+                // Otherwise treat as a duplicate and keep the existing entry.
+                return prev;
+            }
+            const entry = {
+                id: make_id(input.field_id),
+                field_id: input.field_id,
+                source: input.source,
+                at: Date.now(),
+                prev_value: input.prev_value !== undefined ? input.prev_value : last?.new_value,
+                new_value: input.new_value,
+                user: input.user,
+            };
+            const next = new Map(prev);
+            next.set(input.field_id, [entry, ...existing]);
+            return next;
+        });
+    }, []);
+    const toggle_expanded = useCallback((field_id) => {
+        set_expanded((prev) => {
+            const next = new Set(prev);
+            if (next.has(field_id))
+                next.delete(field_id);
+            else
+                next.add(field_id);
+            return next;
+        });
+    }, []);
+    const clear_field = useCallback((field_id) => {
+        set_entries((prev) => {
+            if (!prev.has(field_id))
+                return prev;
+            const next = new Map(prev);
+            next.delete(field_id);
+            return next;
+        });
+        set_expanded((prev) => {
+            if (!prev.has(field_id))
+                return prev;
+            const next = new Set(prev);
+            next.delete(field_id);
+            return next;
+        });
+    }, []);
+    const clear_all = useCallback(() => {
+        set_entries(new Map());
+        set_expanded(new Set());
+    }, []);
+    const value = useMemo(() => ({
+        entries,
+        expanded,
+        record_change,
+        toggle_expanded,
+        clear_field,
+        clear_all,
+    }), [entries, expanded, record_change, toggle_expanded, clear_field, clear_all]);
+    return (_jsx(FieldAuditContext.Provider, { value: value, children: children }));
+}
+export { FieldAuditContext };
+//# sourceMappingURL=context.js.map

package/dist/components/field_audit/context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.js","sourceRoot":"","sources":["../../../src/components/field_audit/context.tsx"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,YAAY,CAAC;;AAEb,OAAc,EACZ,aAAa,EACb,WAAW,EACX,UAAU,EACV,OAAO,EACP,MAAM,EACN,QAAQ,GACT,MAAM,OAAO,CAAC;AAQf,MAAM,iBAAiB,GAAG,aAAa,CACrC,SAAS,CACV,CAAC;AAEF;;GAEG;AACH,MAAM,UAAU,aAAa;IAC3B,MAAM,GAAG,GAAG,UAAU,CAAC,iBAAiB,CAAC,CAAC;IAC1C,IAAI,CAAC,GAAG,EAAE,CAAC;QACT,MAAM,IAAI,KAAK,CAAC,wDAAwD,CAAC,CAAC;IAC5E,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,qBAAqB;IACnC,OAAO,UAAU,CAAC,iBAAiB,CAAC,CAAC;AACvC,CAAC;AAMD,SAAS,OAAO,CAAC,QAAgB;IAC/B,OAAO,GAAG,QAAQ,IAAI,IAAI,CAAC,GAAG,EAAE,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC;AAC/E,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,EAAE,QAAQ,EAA2B;IACtE,MAAM,CAAC,OAAO,EAAE,WAAW,CAAC,GAAG,QAAQ,CACrC,GAAG,EAAE,CAAC,IAAI,GAAG,EAAE,CAChB,CAAC;IACF,MAAM,CAAC,QAAQ,EAAE,YAAY,CAAC,GAAG,QAAQ,CAAc,GAAG,EAAE,CAAC,IAAI,GAAG,EAAE,CAAC,CAAC;IAExE,yEAAyE;IACzE,6EAA6E;IAC7E,MAAM,WAAW,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC;IACpC,WAAW,CAAC,OAAO,GAAG,OAAO,CAAC;IAE9B,MAAM,aAAa,GAAG,WAAW,CAAC,CAAC,KAAwB,EAAE,EAAE;QAC7D,WAAW,CAAC,CAAC,IAAI,EAAE,EAAE;YACnB,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC;YAChD,MAAM,IAAI,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC;YACzB,MAAM,SAAS,GAAG,KAAK,CAAC,eAAe,IAAI,GAAG,CAAC;YAE/C,wDAAwD;YACxD,IACE,IAAI;gBACJ,MAAM,CAAC,EAAE,CAAC,IAAI,CAAC,SAAS,EAAE,KAAK,CAAC,SAAS,CAAC;gBAC1C,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,EAAE,GAAG,SAAS,EAChC,CAAC;gBACD,gEAAgE;gBAChE,kEAAkE;gBAClE,+DAA+D;gBAC/D,qCAAqC;gBACrC,IAAI,IAAI,CAAC,MAAM,KAAK,QAAQ,IAAI,KAAK,CAAC,MAAM,KAAK,QAAQ,EAAE,CAAC;oBAC1D,MAAM,QAAQ,GAAe;wBAC3B,GAAG,IAAI;wBACP,MAAM,EAAE,KAAK,CAAC,MAAM;wBACpB,IAAI,EAAE,KAAK,CAAC,IAAI,IAAI,IAAI,CAAC,IAAI;qBAC9B,CAAC;oBACF,MAAM,IAAI,GAAG,IAAI,GAAG,CAAC,IAAI,CAAC,CAAC;oBAC3B,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;oBAC3D,OAAO,IAAI,CAAC;gBACd,CAAC;gBACD,8DAA8D;gBAC9D,OAAO,IAAI,CAAC;YACd,CAAC;YAED,MAAM,KAAK,GAAe;gBACxB,EAAE,EAAE,OAAO,CAAC,KAAK,CAAC,QAAQ,CAAC;gBAC3B,QAAQ,EAAE,KAAK,CAAC,QAAQ;gBACxB,MAAM,EAAE,KAAK,CAAC,MAAM;gBACpB,EAAE,EAAE,IAAI,CAAC,GAAG,EAAE;gBACd,UAAU,EAAE,KAAK,CAAC,UAAU,KAAK,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC,CAAC,IAAI,EAAE,SAAS;gBAC/E,SAAS,EAAE,KAAK,CAAC,SAAS;gBAC1B,IAAI,EAAE,KAAK,CAAC,IAAI;aACjB,CAAC;YAEF,MAAM,IAAI,GAAG,IAAI,GAAG,CAAC,IAAI,CAAC,CAAC;YAC3B,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,GAAG,QAAQ,CAAC,CAAC,CAAC;YAC/C,OAAO,IAAI,CAAC;QACd,CAAC,CAAC,CAAC;IACL,CAAC,EAAE,EAAE,CAAC,CAAC;IAEP,MAAM,eAAe,GAAG,WAAW,CAAC,CAAC,QAAgB,EAAE,EAAE;QACvD,YAAY,CAAC,CAAC,IAAI,EAAE,EAAE;YACpB,MAAM,IAAI,GAAG,IAAI,GAAG,CAAC,IAAI,CAAC,CAAC;YAC3B,IAAI,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC;gBAAE,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;;gBACzC,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;YACxB,OAAO,IAAI,CAAC;QACd,CAAC,CAAC,CAAC;IACL,CAAC,EAAE,EAAE,CAAC,CAAC;IAEP,MAAM,WAAW,GAAG,WAAW,CAAC,CAAC,QAAgB,EAAE,EAAE;QACnD,WAAW,CAAC,CAAC,IAAI,EAAE,EAAE;YACnB,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC;gBAAE,OAAO,IAAI,CAAC;YACrC,MAAM,IAAI,GAAG,IAAI,GAAG,CAAC,IAAI,CAAC,CAAC;YAC3B,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;YACtB,OAAO,IAAI,CAAC;QACd,CAAC,CAAC,CAAC;QACH,YAAY,CAAC,CAAC,IAAI,EAAE,EAAE;YACpB,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC;gBAAE,OAAO,IAAI,CAAC;YACrC,MAAM,IAAI,GAAG,IAAI,GAAG,CAAC,IAAI,CAAC,CAAC;YAC3B,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;YACtB,OAAO,IAAI,CAAC;QACd,CAAC,CAAC,CAAC;IACL,CAAC,EAAE,EAAE,CAAC,CAAC;IAEP,MAAM,SAAS,GAAG,WAAW,CAAC,GAAG,EAAE;QACjC,WAAW,CAAC,IAAI,GAAG,EAAE,CAAC,CAAC;QACvB,YAAY,CAAC,IAAI,GAAG,EAAE,CAAC,CAAC;IAC1B,CAAC,EAAE,EAAE,CAAC,CAAC;IAEP,MAAM,KAAK,GAAG,OAAO,CACnB,GAAG,EAAE,CAAC,CAAC;QACL,OAAO;QACP,QAAQ;QACR,aAAa;QACb,eAAe;QACf,WAAW;QACX,SAAS;KACV,CAAC,EACF,CAAC,OAAO,EAAE,QAAQ,EAAE,aAAa,EAAE,eAAe,EAAE,WAAW,EAAE,SAAS,CAAC,CAC5E,CAAC;IAEF,OAAO,CACL,KAAC,iBAAiB,CAAC,QAAQ,IAAC,KAAK,EAAE,KAAK,YACrC,QAAQ,GACkB,CAC9B,CAAC;AACJ,CAAC;AAED,OAAO,EAAE,iBAAiB,EAAE,CAAC"}

package/dist/components/field_audit/field_audit_icon.d.ts

@@ -0,0 +1,12 @@
+/**
+ * FieldAuditIcon — designed to be dropped into the
+ * `field_action_components.row_end` slot. Renders a small clock toggle that
+ * opens/closes the audit history panel for the field.
+ *
+ * Visible whenever the field has at least one recorded entry. Hidden when
+ * the audit provider is absent (so it can sit safely in a shared slot).
+ */
+import React from 'react';
+import type { FieldActionContext } from '../hazo_collab_form_view/types.js';
+export declare function FieldAuditIcon({ field }: FieldActionContext): React.ReactElement | null;
+//# sourceMappingURL=field_audit_icon.d.ts.map

package/dist/components/field_audit/field_audit_icon.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"field_audit_icon.d.ts","sourceRoot":"","sources":["../../../src/components/field_audit/field_audit_icon.tsx"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,OAAO,KAAK,MAAM,OAAO,CAAC;AAE1B,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,mCAAmC,CAAC;AAE5E,wBAAgB,cAAc,CAAC,EAAE,KAAK,EAAE,EAAE,kBAAkB,GAAG,KAAK,CAAC,YAAY,GAAG,IAAI,CAiDvF"}

package/dist/components/field_audit/field_audit_icon.js

@@ -0,0 +1,23 @@
+/**
+ * FieldAuditIcon — designed to be dropped into the
+ * `field_action_components.row_end` slot. Renders a small clock toggle that
+ * opens/closes the audit history panel for the field.
+ *
+ * Visible whenever the field has at least one recorded entry. Hidden when
+ * the audit provider is absent (so it can sit safely in a shared slot).
+ */
+'use client';
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { useFieldAuditOptional } from './context.js';
+export function FieldAuditIcon({ field }) {
+    const audit = useFieldAuditOptional();
+    if (!audit)
+        return null;
+    const list = audit.entries.get(field.id) ?? [];
+    if (list.length === 0)
+        return null;
+    const is_open = audit.expanded.has(field.id);
+    const count = list.length;
+    return (_jsxs("button", { type: "button", "data-testid": `field_audit_icon_${field.id}`, "data-state": is_open ? 'open' : 'closed', "aria-expanded": is_open, "aria-label": `Show ${count} audit ${count === 1 ? 'entry' : 'entries'} for ${field.id}`, title: `${count} change${count === 1 ? '' : 's'} recorded`, onClick: () => audit.toggle_expanded(field.id), className: "cls_field_audit_icon inline-flex items-center justify-center gap-1 h-7 px-2 rounded-md text-[11px] font-medium text-amber-700 hover:bg-amber-50 hover:text-amber-900 transition-colors", children: [_jsxs("svg", { "aria-hidden": "true", viewBox: "0 0 24 24", fill: "none", stroke: "currentColor", strokeWidth: "2", strokeLinecap: "round", strokeLinejoin: "round", className: "h-3.5 w-3.5", children: [_jsx("circle", { cx: "12", cy: "12", r: "9" }), _jsx("polyline", { points: "12 7 12 12 15 14" })] }), _jsx("span", { className: "font-mono", children: count }), _jsx("svg", { "aria-hidden": "true", viewBox: "0 0 24 24", fill: "none", stroke: "currentColor", strokeWidth: "2", strokeLinecap: "round", strokeLinejoin: "round", className: `h-3 w-3 transition-transform ${is_open ? 'rotate-180' : ''}`, children: _jsx("polyline", { points: "6 9 12 15 18 9" }) })] }));
+}
+//# sourceMappingURL=field_audit_icon.js.map

package/dist/components/field_audit/field_audit_icon.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"field_audit_icon.js","sourceRoot":"","sources":["../../../src/components/field_audit/field_audit_icon.tsx"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,YAAY,CAAC;;AAGb,OAAO,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAC;AAGrD,MAAM,UAAU,cAAc,CAAC,EAAE,KAAK,EAAsB;IAC1D,MAAM,KAAK,GAAG,qBAAqB,EAAE,CAAC;IACtC,IAAI,CAAC,KAAK;QAAE,OAAO,IAAI,CAAC;IAExB,MAAM,IAAI,GAAG,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC;IAC/C,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IAEnC,MAAM,OAAO,GAAG,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;IAC7C,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC;IAE1B,OAAO,CACL,kBACE,IAAI,EAAC,QAAQ,iBACA,oBAAoB,KAAK,CAAC,EAAE,EAAE,gBAC/B,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,QAAQ,mBACxB,OAAO,gBACV,QAAQ,KAAK,UAAU,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,QAAQ,KAAK,CAAC,EAAE,EAAE,EACtF,KAAK,EAAE,GAAG,KAAK,UAAU,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,WAAW,EAC1D,OAAO,EAAE,GAAG,EAAE,CAAC,KAAK,CAAC,eAAe,CAAC,KAAK,CAAC,EAAE,CAAC,EAC9C,SAAS,EAAC,wLAAwL,aAElM,8BACc,MAAM,EAClB,OAAO,EAAC,WAAW,EACnB,IAAI,EAAC,MAAM,EACX,MAAM,EAAC,cAAc,EACrB,WAAW,EAAC,GAAG,EACf,aAAa,EAAC,OAAO,EACrB,cAAc,EAAC,OAAO,EACtB,SAAS,EAAC,aAAa,aAEvB,iBAAQ,EAAE,EAAC,IAAI,EAAC,EAAE,EAAC,IAAI,EAAC,CAAC,EAAC,GAAG,GAAG,EAChC,mBAAU,MAAM,EAAC,kBAAkB,GAAG,IAClC,EACN,eAAM,SAAS,EAAC,WAAW,YAAE,KAAK,GAAQ,EAC1C,6BACc,MAAM,EAClB,OAAO,EAAC,WAAW,EACnB,IAAI,EAAC,MAAM,EACX,MAAM,EAAC,cAAc,EACrB,WAAW,EAAC,GAAG,EACf,aAAa,EAAC,OAAO,EACrB,cAAc,EAAC,OAAO,EACtB,SAAS,EAAE,gCAAgC,OAAO,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,EAAE,EAAE,YAExE,mBAAU,MAAM,EAAC,gBAAgB,GAAG,GAChC,IACC,CACV,CAAC;AACJ,CAAC"}

package/dist/components/field_audit/field_audit_panel.d.ts

@@ -0,0 +1,9 @@
+/**
+ * FieldAuditPanel — designed to be dropped into the
+ * `field_action_components.row_below` slot. Renders the per-field history
+ * list when the icon is toggled open.
+ */
+import React from 'react';
+import type { FieldActionContext } from '../hazo_collab_form_view/types.js';
+export declare function FieldAuditPanel({ field }: FieldActionContext): React.ReactElement | null;
+//# sourceMappingURL=field_audit_panel.d.ts.map

package/dist/components/field_audit/field_audit_panel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"field_audit_panel.d.ts","sourceRoot":"","sources":["../../../src/components/field_audit/field_audit_panel.tsx"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,OAAO,KAAK,MAAM,OAAO,CAAC;AAE1B,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,mCAAmC,CAAC;AAsD5E,wBAAgB,eAAe,CAAC,EAAE,KAAK,EAAE,EAAE,kBAAkB,GAAG,KAAK,CAAC,YAAY,GAAG,IAAI,CAiCxF"}

package/dist/components/field_audit/field_audit_panel.js

@@ -0,0 +1,54 @@
+/**
+ * FieldAuditPanel — designed to be dropped into the
+ * `field_action_components.row_below` slot. Renders the per-field history
+ * list when the icon is toggled open.
+ */
+'use client';
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { useFieldAuditOptional } from './context.js';
+function format_value(value) {
+    if (value === undefined)
+        return '—';
+    if (value === null)
+        return 'null';
+    if (typeof value === 'string')
+        return value === '' ? '""' : `"${value}"`;
+    if (typeof value === 'number' || typeof value === 'boolean')
+        return String(value);
+    try {
+        return JSON.stringify(value);
+    }
+    catch {
+        return String(value);
+    }
+}
+function format_time(at) {
+    const date = new Date(at);
+    const hh = String(date.getHours()).padStart(2, '0');
+    const mm = String(date.getMinutes()).padStart(2, '0');
+    const ss = String(date.getSeconds()).padStart(2, '0');
+    return `${hh}:${mm}:${ss}`;
+}
+function source_label(source) {
+    switch (source) {
+        case 'manual':
+            return 'edit';
+        case 'clarification':
+            return 'clarification';
+    }
+}
+function EntryRow({ entry }) {
+    return (_jsxs("li", { className: "cls_field_audit_entry flex items-baseline gap-2 px-2 py-1 text-[11px] font-mono", children: [_jsx("span", { className: "text-amber-700/70 shrink-0", children: format_time(entry.at) }), _jsx("span", { className: "text-amber-900 shrink-0 uppercase tracking-wide text-[10px]", children: source_label(entry.source) }), entry.user && (_jsx("span", { className: "text-slate-600 shrink-0", children: entry.user })), _jsxs("span", { className: "text-slate-500 truncate", children: [format_value(entry.prev_value), " ", _jsx("span", { "aria-hidden": true, children: "\u2192" }), ' ', _jsx("span", { className: "text-emerald-700", children: format_value(entry.new_value) })] })] }));
+}
+export function FieldAuditPanel({ field }) {
+    const audit = useFieldAuditOptional();
+    if (!audit)
+        return null;
+    if (!audit.expanded.has(field.id))
+        return null;
+    const list = audit.entries.get(field.id) ?? [];
+    if (list.length === 0)
+        return null;
+    return (_jsxs("div", { "data-testid": `field_audit_panel_${field.id}`, className: "cls_field_audit_panel mx-3 mb-2 rounded-md border border-amber-200 bg-amber-50/60", children: [_jsxs("div", { className: "flex items-center justify-between px-2 py-1 border-b border-amber-200/60", children: [_jsxs("span", { className: "text-[10px] uppercase tracking-wide text-amber-800", children: ["Field audit \u00B7 ", list.length, " change", list.length === 1 ? '' : 's'] }), _jsx("button", { type: "button", onClick: () => audit.clear_field(field.id), "aria-label": `Clear audit history for ${field.id}`, className: "text-[10px] text-amber-700/70 hover:text-red-600", children: "Clear" })] }), _jsx("ol", { className: "divide-y divide-amber-100", children: list.map((entry) => (_jsx(EntryRow, { entry: entry }, entry.id))) })] }));
+}
+//# sourceMappingURL=field_audit_panel.js.map

package/dist/components/field_audit/field_audit_panel.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"field_audit_panel.js","sourceRoot":"","sources":["../../../src/components/field_audit/field_audit_panel.tsx"],"names":[],"mappings":"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"}

package/dist/components/field_audit/index.d.ts

@@ -0,0 +1,33 @@
+/**
+ * @deprecated The in-session FieldAudit module is deprecated as of v5.10.0.
+ * Install hazo_audit and use the `field_audit` prop on HazoCollabFormView or
+ * HazoDataForm instead. This module will be removed in a future major.
+ */
+/**
+ * FieldAudit — in-session per-field change history.
+ *
+ * Exports:
+ * - `FieldAuditProvider` — wraps your form and holds the entries map.
+ * - `FormDataAuditor` — invisible component that auto-records changes to
+ *   `form_data` as `manual` entries.
+ * - `FieldAuditIcon` — designed for the `row_end` action slot.
+ * - `FieldAuditPanel` — designed for the `row_below` action slot.
+ * - `useFieldAudit` / `useFieldAuditOptional` — context hooks (use the
+ *   imperative API from inside the provider to record non-manual sources
+ *   such as `clarification`).
+ *
+ * The form view components (`HazoCollabFormView`, `HazoDataForm`,
+ * `ThreadForm`) accept an `enable_field_audit?: boolean` convenience flag
+ * that mounts the provider, the auditor, and merges the icon/panel into
+ * `field_action_components` for you.
+ */
+export { FieldAuditProvider, FieldAuditContext, useFieldAudit, useFieldAuditOptional, } from './context.js';
+export type { FieldAuditProviderProps } from './context.js';
+export { FormDataAuditor } from './auditor.js';
+export type { FormDataAuditorProps } from './auditor.js';
+export { FieldAuditIcon } from './field_audit_icon.js';
+export { FieldAuditPanel } from './field_audit_panel.js';
+export { useFieldAuditWiring } from './with_field_audit.js';
+export type { FieldAuditWiring, UseFieldAuditWiringOptions, } from './with_field_audit.js';
+export type { AuditEntry, AuditSource, FieldAuditContextValue, RecordChangeInput, } from './types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/components/field_audit/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/field_audit/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,EACL,kBAAkB,EAClB,iBAAiB,EACjB,aAAa,EACb,qBAAqB,GACtB,MAAM,cAAc,CAAC;AACtB,YAAY,EAAE,uBAAuB,EAAE,MAAM,cAAc,CAAC;AAE5D,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAC/C,YAAY,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AAEzD,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAEzD,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAC5D,YAAY,EACV,gBAAgB,EAChB,0BAA0B,GAC3B,MAAM,uBAAuB,CAAC;AAE/B,YAAY,EACV,UAAU,EACV,WAAW,EACX,sBAAsB,EACtB,iBAAiB,GAClB,MAAM,YAAY,CAAC"}

package/dist/components/field_audit/index.js

@@ -0,0 +1,29 @@
+/**
+ * @deprecated The in-session FieldAudit module is deprecated as of v5.10.0.
+ * Install hazo_audit and use the `field_audit` prop on HazoCollabFormView or
+ * HazoDataForm instead. This module will be removed in a future major.
+ */
+/**
+ * FieldAudit — in-session per-field change history.
+ *
+ * Exports:
+ * - `FieldAuditProvider` — wraps your form and holds the entries map.
+ * - `FormDataAuditor` — invisible component that auto-records changes to
+ *   `form_data` as `manual` entries.
+ * - `FieldAuditIcon` — designed for the `row_end` action slot.
+ * - `FieldAuditPanel` — designed for the `row_below` action slot.
+ * - `useFieldAudit` / `useFieldAuditOptional` — context hooks (use the
+ *   imperative API from inside the provider to record non-manual sources
+ *   such as `clarification`).
+ *
+ * The form view components (`HazoCollabFormView`, `HazoDataForm`,
+ * `ThreadForm`) accept an `enable_field_audit?: boolean` convenience flag
+ * that mounts the provider, the auditor, and merges the icon/panel into
+ * `field_action_components` for you.
+ */
+export { FieldAuditProvider, FieldAuditContext, useFieldAudit, useFieldAuditOptional, } from './context.js';
+export { FormDataAuditor } from './auditor.js';
+export { FieldAuditIcon } from './field_audit_icon.js';
+export { FieldAuditPanel } from './field_audit_panel.js';
+export { useFieldAuditWiring } from './with_field_audit.js';
+//# sourceMappingURL=index.js.map

package/dist/components/field_audit/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/components/field_audit/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,EACL,kBAAkB,EAClB,iBAAiB,EACjB,aAAa,EACb,qBAAqB,GACtB,MAAM,cAAc,CAAC;AAGtB,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAG/C,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAEzD,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC"}

package/dist/components/field_audit/types.d.ts

@@ -0,0 +1,75 @@
+/**
+ * Types for the FieldAudit module.
+ *
+ * FieldAudit records per-field value changes inside a form session and
+ * exposes them as a clickable history panel next to each field row. It
+ * pairs with the `field_action_components` slot machinery — `FieldAuditIcon`
+ * goes into `row_end` and `FieldAuditPanel` into `row_below`.
+ */
+/**
+ * Origin of an audit entry.
+ *
+ * - `manual` — Direct user edit picked up by the auto-watcher.
+ * - `clarification` — A clarification flow resolved into a value update.
+ *   The clarification handler must call `record_change()` explicitly so the
+ *   auto-watcher's manual entry gets reclassified (see dedup below).
+ */
+export type AuditSource = 'manual' | 'clarification';
+/**
+ * A single entry in the per-field audit history.
+ */
+export interface AuditEntry {
+    /** Unique id (used as React key). */
+    id: string;
+    /** The field that changed. */
+    field_id: string;
+    /** Where the change came from. */
+    source: AuditSource;
+    /** Wall-clock timestamp (ms since epoch) at the moment the entry was recorded. */
+    at: number;
+    /** Value immediately before the change. */
+    prev_value: unknown;
+    /** Value immediately after the change. */
+    new_value: unknown;
+    /** Optional human-readable label for the actor that made the change. */
+    user?: string;
+}
+/**
+ * Input shape for `record_change()`.
+ */
+export interface RecordChangeInput {
+    field_id: string;
+    source: AuditSource;
+    new_value: unknown;
+    /** Falls back to the most recent recorded value if omitted. */
+    prev_value?: unknown;
+    user?: string;
+    /**
+     * Dedup window in ms. If the most-recent entry for this field has the
+     * same new value within the window, the call is treated as a duplicate
+     * of the existing entry.
+     *
+     * When the call carries a more specific source (`'clarification'`) than
+     * the existing entry (`'manual'` from the auto-watcher), the existing
+     * entry is reclassified instead of duplicated.
+     */
+    dedup_window_ms?: number;
+}
+/**
+ * Context value exposed by `<FieldAuditProvider>`.
+ */
+export interface FieldAuditContextValue {
+    /** Per-field history, most-recent-first. */
+    entries: Map<string, AuditEntry[]>;
+    /** Field ids whose history panel is currently expanded. */
+    expanded: Set<string>;
+    /** Record a change. Auto-watcher uses this with `source='manual'`. */
+    record_change: (input: RecordChangeInput) => void;
+    /** Toggle the row_below history panel for one field. */
+    toggle_expanded: (field_id: string) => void;
+    /** Drop history for one field (and collapse it). */
+    clear_field: (field_id: string) => void;
+    /** Drop history for every field. */
+    clear_all: () => void;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/components/field_audit/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/components/field_audit/types.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH;;;;;;;GAOG;AACH,MAAM,MAAM,WAAW,GAAG,QAAQ,GAAG,eAAe,CAAC;AAErD;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,qCAAqC;IACrC,EAAE,EAAE,MAAM,CAAC;IACX,8BAA8B;IAC9B,QAAQ,EAAE,MAAM,CAAC;IACjB,kCAAkC;IAClC,MAAM,EAAE,WAAW,CAAC;IACpB,kFAAkF;IAClF,EAAE,EAAE,MAAM,CAAC;IACX,2CAA2C;IAC3C,UAAU,EAAE,OAAO,CAAC;IACpB,0CAA0C;IAC1C,SAAS,EAAE,OAAO,CAAC;IACnB,wEAAwE;IACxE,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,WAAW,CAAC;IACpB,SAAS,EAAE,OAAO,CAAC;IACnB,+DAA+D;IAC/D,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd;;;;;;;;OAQG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,4CAA4C;IAC5C,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,UAAU,EAAE,CAAC,CAAC;IACnC,2DAA2D;IAC3D,QAAQ,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IACtB,sEAAsE;IACtE,aAAa,EAAE,CAAC,KAAK,EAAE,iBAAiB,KAAK,IAAI,CAAC;IAClD,wDAAwD;IACxD,eAAe,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,IAAI,CAAC;IAC5C,oDAAoD;IACpD,WAAW,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,IAAI,CAAC;IACxC,oCAAoC;IACpC,SAAS,EAAE,MAAM,IAAI,CAAC;CACvB"}

package/dist/components/field_audit/types.js

@@ -0,0 +1,10 @@
+/**
+ * Types for the FieldAudit module.
+ *
+ * FieldAudit records per-field value changes inside a form session and
+ * exposes them as a clickable history panel next to each field row. It
+ * pairs with the `field_action_components` slot machinery — `FieldAuditIcon`
+ * goes into `row_end` and `FieldAuditPanel` into `row_below`.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/components/field_audit/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/components/field_audit/types.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG"}

package/dist/components/field_audit/with_field_audit.d.ts

@@ -0,0 +1,32 @@
+/**
+ * with_field_audit — internal helper that wires the FieldAudit feature into
+ * a form view when `enable_field_audit` is true.
+ *
+ * Returns:
+ *  - `wrap(children)` — wraps the children in a FieldAuditProvider + a
+ *    FormDataAuditor that watches the current `form_data`.
+ *  - `merged_components` — the `field_action_components` value to feed into
+ *    the form's context. Consumer-supplied slots win on collision so they
+ *    can be combined with the audit overlay.
+ *
+ * When `enable_field_audit` is false this helper is a no-op: `wrap` returns
+ * its children unchanged and `merged_components` is the original prop.
+ */
+import type { ReactNode } from 'react';
+import type { FieldActionComponents } from '../hazo_collab_form_view/types.js';
+export interface UseFieldAuditWiringOptions {
+    enable_field_audit?: boolean;
+    field_action_components?: FieldActionComponents;
+    form_data: Record<string, unknown> | undefined;
+    current_user?: string;
+    /** Forwarded to FormDataAuditor — defaults to 750ms. */
+    audit_debounce_ms?: number;
+}
+export interface FieldAuditWiring {
+    /** Final `field_action_components` to pass into the form view's context. */
+    merged_components: FieldActionComponents | undefined;
+    /** Wraps the form view's children with the audit provider + watcher. */
+    wrap: (children: ReactNode) => ReactNode;
+}
+export declare function useFieldAuditWiring(options: UseFieldAuditWiringOptions): FieldAuditWiring;
+//# sourceMappingURL=with_field_audit.d.ts.map

package/dist/components/field_audit/with_field_audit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"with_field_audit.d.ts","sourceRoot":"","sources":["../../../src/components/field_audit/with_field_audit.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAKH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AACvC,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,mCAAmC,CAAC;AAM/E,MAAM,WAAW,0BAA0B;IACzC,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,uBAAuB,CAAC,EAAE,qBAAqB,CAAC;IAChD,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAAC;IAC/C,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,wDAAwD;IACxD,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED,MAAM,WAAW,gBAAgB;IAC/B,4EAA4E;IAC5E,iBAAiB,EAAE,qBAAqB,GAAG,SAAS,CAAC;IACrD,wEAAwE;IACxE,IAAI,EAAE,CAAC,QAAQ,EAAE,SAAS,KAAK,SAAS,CAAC;CAC1C;AAED,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,0BAA0B,GAAG,gBAAgB,CAoCzF"}

package/dist/components/field_audit/with_field_audit.js

@@ -0,0 +1,42 @@
+/**
+ * with_field_audit — internal helper that wires the FieldAudit feature into
+ * a form view when `enable_field_audit` is true.
+ *
+ * Returns:
+ *  - `wrap(children)` — wraps the children in a FieldAuditProvider + a
+ *    FormDataAuditor that watches the current `form_data`.
+ *  - `merged_components` — the `field_action_components` value to feed into
+ *    the form's context. Consumer-supplied slots win on collision so they
+ *    can be combined with the audit overlay.
+ *
+ * When `enable_field_audit` is false this helper is a no-op: `wrap` returns
+ * its children unchanged and `merged_components` is the original prop.
+ */
+'use client';
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { useMemo } from 'react';
+import { FieldAuditProvider } from './context.js';
+import { FormDataAuditor } from './auditor.js';
+import { FieldAuditIcon } from './field_audit_icon.js';
+import { FieldAuditPanel } from './field_audit_panel.js';
+export function useFieldAuditWiring(options) {
+    const { enable_field_audit, field_action_components, form_data, current_user, audit_debounce_ms, } = options;
+    const merged_components = useMemo(() => {
+        if (!enable_field_audit)
+            return field_action_components;
+        return {
+            row_end: field_action_components?.row_end ?? FieldAuditIcon,
+            row_below: field_action_components?.row_below ?? FieldAuditPanel,
+        };
+    }, [enable_field_audit, field_action_components]);
+    const wrap = useMemo(() => {
+        if (!enable_field_audit) {
+            return (children) => children;
+        }
+        return (children) => (_jsxs(FieldAuditProvider, { children: [_jsx(FormDataAuditor, { form_data: form_data, current_user: current_user, debounce_ms: audit_debounce_ms }), children] }));
+        // form_data identity must be allowed to refresh the watcher; current_user
+        // typically stable.
+    }, [enable_field_audit, form_data, current_user, audit_debounce_ms]);
+    return { merged_components, wrap };
+}
+//# sourceMappingURL=with_field_audit.js.map