hazo_collab_forms 1.9.0 → 1.9.1

package/dist/components/shared/strip_base_props.js

@@ -0,0 +1,91 @@
+/**
+ * Utility to strip CollabFormFieldBaseProps keys from a props object,
+ * leaving only DOM-safe rest props for spreading onto native elements.
+ *
+ * This replaces the massive destructuring block in each form component
+ * where every base prop is assigned to an unused `_` variable just to
+ * get the `...rest` for the underlying input element.
+ */
+/** All known prop keys from CollabFormFieldBaseProps and common form component props */
+const BASE_PROP_KEYS = new Set([
+    // CollabFormFieldBaseProps
+    'label', 'tooltip', 'error', 'field_id', 'field_data_id', 'field_name',
+    'on_chat_click', 'has_chat_messages', 'chat_status', 'is_chat_active',
+    'chat_background_color', 'is_data_ok_default', 'data_ok_checked',
+    'on_data_ok_change', 'data_ok_mode', 'data_ok_value', 'on_data_ok_value_change',
+    'container_class_name', 'row_background_color', 'label_class_name', 'label_actions',
+    'field_wrapper_class_name', 'error_class_name', 'field_width_class_name',
+    'required', 'multi_state_radio',
+    // hazo_chat props
+    'hazo_chat_group_id', 'hazo_chat_reference_id', 'hazo_chat_reference_type',
+    'hazo_chat_api_base_url', 'hazo_chat_timezone', 'hazo_chat_title',
+    'hazo_chat_subtitle', 'hazo_chat_realtime_mode', 'hazo_chat_polling_interval',
+    'hazo_chat_messages_per_page', 'hazo_chat_class_name', 'hazo_chat_on_close',
+    'hazo_chat_is_open', 'hazo_chat_on_open_change', 'hazo_chat_show_sidebar_toggle',
+    'hazo_chat_show_delete_button', 'hazo_chat_bubble_radius', 'hazo_chat_read_only',
+    'hazo_chat_hide_references', 'hazo_chat_hide_sidebar', 'hazo_chat_hide_preview',
+    'hazo_chat_display_mode', 'hazo_chat_container_element', 'hazo_chat_log_polling',
+    // data_ok props
+    'disable_data_ok', 'disable_chat', 'data_ok_editable', 'data_ok_default',
+    'data_ok_hidden_states',
+    // file props
+    'accept_files_public', 'accept_files_private', 'files_dir', 'max_size', 'min_files', 'max_files',
+    'file_accept', 'file_processor', 'files', 'on_files_change', 'file_validator',
+    'field_validator',
+    'private_files_permission', 'can_access_private_files',
+    'private_files', 'on_private_files_change',
+    // notes props
+    'enable_notes', 'disable_notes', 'notes', 'on_notes_change',
+    'has_notes', 'is_notes_active', 'notes_panel_style', 'notes_background_color',
+    'notes_save_mode', 'current_user',
+    // reference tag props
+    'reference_value', 'reference_label', 'reference_tag_background_color',
+    // visibility props
+    'enable_visibility_toggle', 'disable_visibility_toggle', 'visibility',
+    'on_visibility_change', 'user_role',
+    // additional entry props
+    'additional_entry', 'max_additional_entries', 'entry_index', 'entry_count',
+    'on_add_entry', 'on_delete_entry', 'is_additional_entry',
+    // delete props
+    'enable_delete', 'disable_delete', 'on_delete',
+    // lock props
+    'enable_lock', 'disable_lock', 'locked', 'on_lock_change',
+    // skip props
+    'enable_skip', 'disable_skip', 'skipped', 'on_skip_change',
+    // display props
+    'edit_actions_display', 'action_buttons_borderless',
+    // dropdown consolidation
+    'include_chat_in_dropdown', 'include_notes_in_dropdown',
+    'extract_active_chat', 'extract_active_notes',
+    // icons_behaviour
+    'icons_behaviour', 'active_role',
+    // common component-specific props that should be stripped
+    'additional_context',
+    // these are handled by the component itself, not the DOM
+    'input_wrapper_class_name', 'textarea_wrapper_class_name',
+    'checkbox_wrapper_class_name', 'checkbox_label_class_name', 'checkbox_label',
+    'radio_wrapper_class_name', 'radio_option_wrapper_class_name', 'layout',
+    'combo_wrapper_class_name', 'button_class_name', 'enable_search',
+    'search_placeholder', 'empty_message', 'placeholder', 'options',
+    'date_wrapper_class_name', 'date_mode', 'min_date', 'max_date',
+    'disabled_dates', 'caption_layout', 'start_month', 'end_month', 'date_format',
+    'dropzone_class_name', 'dropzone_wrapper_class_name', 'upload_endpoint',
+]);
+/**
+ * Strip all known base/internal props from the props object,
+ * returning only DOM-safe attributes for spreading onto native elements.
+ *
+ * Also strips hazo_chat_* and hazo_notes_* prefixed props as a safety net.
+ */
+export function strip_base_props(props) {
+    const result = {};
+    for (const key of Object.keys(props)) {
+        if (BASE_PROP_KEYS.has(key))
+            continue;
+        if (key.startsWith('hazo_chat_') || key.startsWith('hazo_notes_'))
+            continue;
+        result[key] = props[key];
+    }
+    return result;
+}
+//# sourceMappingURL=strip_base_props.js.map

package/dist/components/shared/strip_base_props.js.map

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

package/dist/components/shared/summary_utils/file_helpers.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Shared file extraction helpers for reading field-level files from form_data.
+ * Used by summary_view, print_view, approval_view, and any other view that
+ * reads files stored at __files_${field_id} / __private_files_${field_id}.
+ */
+import type { FileData } from '../../hazo_collab_form_base.js';
+/** Extract public files for a field from form_data */
+export declare function get_field_files(form_data: Record<string, unknown>, field_id: string): FileData[];
+/** Extract private files for a field from form_data */
+export declare function get_field_private_files(form_data: Record<string, unknown>, field_id: string): FileData[];
+//# sourceMappingURL=file_helpers.d.ts.map

package/dist/components/shared/summary_utils/file_helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file_helpers.d.ts","sourceRoot":"","sources":["../../../../src/components/shared/summary_utils/file_helpers.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gCAAgC,CAAC;AAE/D,sDAAsD;AACtD,wBAAgB,eAAe,CAAC,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,QAAQ,EAAE,MAAM,GAAG,QAAQ,EAAE,CAGhG;AAED,uDAAuD;AACvD,wBAAgB,uBAAuB,CAAC,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,QAAQ,EAAE,MAAM,GAAG,QAAQ,EAAE,CAGxG"}

package/dist/components/shared/summary_utils/file_helpers.js

@@ -0,0 +1,16 @@
+/**
+ * Shared file extraction helpers for reading field-level files from form_data.
+ * Used by summary_view, print_view, approval_view, and any other view that
+ * reads files stored at __files_${field_id} / __private_files_${field_id}.
+ */
+/** Extract public files for a field from form_data */
+export function get_field_files(form_data, field_id) {
+    const files = form_data[`__files_${field_id}`];
+    return Array.isArray(files) ? files : [];
+}
+/** Extract private files for a field from form_data */
+export function get_field_private_files(form_data, field_id) {
+    const files = form_data[`__private_files_${field_id}`];
+    return Array.isArray(files) ? files : [];
+}
+//# sourceMappingURL=file_helpers.js.map

package/dist/components/shared/summary_utils/file_helpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"file_helpers.js","sourceRoot":"","sources":["../../../../src/components/shared/summary_utils/file_helpers.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,sDAAsD;AACtD,MAAM,UAAU,eAAe,CAAC,SAAkC,EAAE,QAAgB;IAClF,MAAM,KAAK,GAAG,SAAS,CAAC,WAAW,QAAQ,EAAE,CAAC,CAAC;IAC/C,OAAO,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAmB,CAAC,CAAC,CAAC,EAAE,CAAC;AACzD,CAAC;AAED,uDAAuD;AACvD,MAAM,UAAU,uBAAuB,CAAC,SAAkC,EAAE,QAAgB;IAC1F,MAAM,KAAK,GAAG,SAAS,CAAC,mBAAmB,QAAQ,EAAE,CAAC,CAAC;IACvD,OAAO,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAmB,CAAC,CAAC,CAAC,EAAE,CAAC;AACzD,CAAC"}

package/dist/components/shared/summary_utils/index.d.ts

@@ -1,2 +1,3 @@
 export { format_date_value, get_display_label } from './summary_utils.js';
+export { get_field_files, get_field_private_files } from './file_helpers.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/components/shared/summary_utils/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/components/shared/summary_utils/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/components/shared/summary_utils/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAC1E,OAAO,EAAE,eAAe,EAAE,uBAAuB,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/components/shared/summary_utils/index.js

@@ -1,2 +1,3 @@
 export { format_date_value, get_display_label } from './summary_utils.js';
+export { get_field_files, get_field_private_files } from './file_helpers.js';
 //# sourceMappingURL=index.js.map

package/dist/components/shared/summary_utils/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/components/shared/summary_utils/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/components/shared/summary_utils/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAC1E,OAAO,EAAE,eAAe,EAAE,uBAAuB,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/components/shared/unified_field_controls/index.d.ts

@@ -40,6 +40,7 @@
 export { UnifiedFieldControls } from './unified_field_controls.js';
 export { KebabMenu } from './kebab_menu.js';
 export { use_control_resolution } from './use_control_resolution.js';
+export { use_field_control_props, type UseFieldControlPropsInput } from './use_field_control_props.js';
 export { resolve_field_controls, controls_to_fallback_visibility, type ControlEnableSettings, type ResolvedControlSettings, } from './resolve_field_controls.js';
 export { build_control_props, type FieldControlConfig, type FormControlContext, type FormControlCallbacks, } from './build_control_props.js';
 export type { UnifiedFieldControlsProps, ControlMetadata, ControlCallbacks, ControlConfig, FallbackSettings, DataOkAutoActions, ResolvedControlState, ControlResolutionResult, KebabMenuProps, IconsBehaviour, ControlName, DataOkState, ChatStatus, NoteEntry, } from './types.js';

package/dist/components/shared/unified_field_controls/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/components/shared/unified_field_controls/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsCG;AAGH,OAAO,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AAGnE,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAG5C,OAAO,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAC;AAGrE,OAAO,EACL,sBAAsB,EACtB,+BAA+B,EAC/B,KAAK,qBAAqB,EAC1B,KAAK,uBAAuB,GAC7B,MAAM,6BAA6B,CAAC;AAGrC,OAAO,EACL,mBAAmB,EACnB,KAAK,kBAAkB,EACvB,KAAK,kBAAkB,EACvB,KAAK,oBAAoB,GAC1B,MAAM,0BAA0B,CAAC;AAGlC,YAAY,EACV,yBAAyB,EACzB,eAAe,EACf,gBAAgB,EAChB,aAAa,EACb,gBAAgB,EAChB,iBAAiB,EACjB,oBAAoB,EACpB,uBAAuB,EACvB,cAAc,EACd,cAAc,EACd,WAAW,EACX,WAAW,EACX,UAAU,EACV,SAAS,GACV,MAAM,YAAY,CAAC;AAGpB,OAAO,EACL,YAAY,EACZ,eAAe,EACf,2BAA2B,EAC3B,wBAAwB,EACxB,uBAAuB,EACvB,mBAAmB,EACnB,sBAAsB,GACvB,MAAM,gBAAgB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/components/shared/unified_field_controls/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsCG;AAGH,OAAO,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AAGnE,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAG5C,OAAO,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAC;AACrE,OAAO,EAAE,uBAAuB,EAAE,KAAK,yBAAyB,EAAE,MAAM,8BAA8B,CAAC;AAGvG,OAAO,EACL,sBAAsB,EACtB,+BAA+B,EAC/B,KAAK,qBAAqB,EAC1B,KAAK,uBAAuB,GAC7B,MAAM,6BAA6B,CAAC;AAGrC,OAAO,EACL,mBAAmB,EACnB,KAAK,kBAAkB,EACvB,KAAK,kBAAkB,EACvB,KAAK,oBAAoB,GAC1B,MAAM,0BAA0B,CAAC;AAGlC,YAAY,EACV,yBAAyB,EACzB,eAAe,EACf,gBAAgB,EAChB,aAAa,EACb,gBAAgB,EAChB,iBAAiB,EACjB,oBAAoB,EACpB,uBAAuB,EACvB,cAAc,EACd,cAAc,EACd,WAAW,EACX,WAAW,EACX,UAAU,EACV,SAAS,GACV,MAAM,YAAY,CAAC;AAGpB,OAAO,EACL,YAAY,EACZ,eAAe,EACf,2BAA2B,EAC3B,wBAAwB,EACxB,uBAAuB,EACvB,mBAAmB,EACnB,sBAAsB,GACvB,MAAM,gBAAgB,CAAC"}

package/dist/components/shared/unified_field_controls/index.js

@@ -41,8 +41,9 @@
 export { UnifiedFieldControls } from './unified_field_controls.js';
 // Sub-components
 export { KebabMenu } from './kebab_menu.js';
-// Hook
+// Hooks
 export { use_control_resolution } from './use_control_resolution.js';
+export { use_field_control_props } from './use_field_control_props.js';
 // Field-level control resolution
 export { resolve_field_controls, controls_to_fallback_visibility, } from './resolve_field_controls.js';
 // Prop building utilities

package/dist/components/shared/unified_field_controls/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/components/shared/unified_field_controls/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsCG;AAEH,iBAAiB;AACjB,OAAO,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AAEnE,iBAAiB;AACjB,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAE5C,OAAO;AACP,OAAO,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAC;AAErE,iCAAiC;AACjC,OAAO,EACL,sBAAsB,EACtB,+BAA+B,GAGhC,MAAM,6BAA6B,CAAC;AAErC,0BAA0B;AAC1B,OAAO,EACL,mBAAmB,GAIpB,MAAM,0BAA0B,CAAC;AAoBlC,YAAY;AACZ,OAAO,EACL,YAAY,EACZ,eAAe,EACf,2BAA2B,EAC3B,wBAAwB,EACxB,uBAAuB,EACvB,mBAAmB,EACnB,sBAAsB,GACvB,MAAM,gBAAgB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/components/shared/unified_field_controls/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsCG;AAEH,iBAAiB;AACjB,OAAO,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AAEnE,iBAAiB;AACjB,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAE5C,QAAQ;AACR,OAAO,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAC;AACrE,OAAO,EAAE,uBAAuB,EAAkC,MAAM,8BAA8B,CAAC;AAEvG,iCAAiC;AACjC,OAAO,EACL,sBAAsB,EACtB,+BAA+B,GAGhC,MAAM,6BAA6B,CAAC;AAErC,0BAA0B;AAC1B,OAAO,EACL,mBAAmB,GAIpB,MAAM,0BAA0B,CAAC;AAoBlC,YAAY;AACZ,OAAO,EACL,YAAY,EACZ,eAAe,EACf,2BAA2B,EAC3B,wBAAwB,EACxB,uBAAuB,EACvB,mBAAmB,EACnB,sBAAsB,GACvB,MAAM,gBAAgB,CAAC"}

package/dist/components/shared/unified_field_controls/use_field_control_props.d.ts

@@ -0,0 +1,68 @@
+/**
+ * Shared hook for building UnifiedFieldControls props.
+ *
+ * Summary view duplicates these 6 useMemo blocks identically in both
+ * SummaryGroup and SummaryField. This hook consolidates them into one call.
+ */
+import type { ControlMetadata, ControlCallbacks, ControlConfig, FallbackSettings } from './types.js';
+import type { FieldMetadataInput } from '../field_state/types.js';
+/** Inputs for the hook */
+export interface UseFieldControlPropsInput {
+    /** Whether show_icons is enabled for this field/group */
+    has_controls: boolean;
+    /** Field ID */
+    field_id: string;
+    /** Field label (used in control_config) */
+    field_label: string;
+    /** Entity type: 'group' | 'field' */
+    entity_type: 'group' | 'field';
+    /** icons_behaviour from context */
+    icons_behaviour: any;
+    /** Active role from settings */
+    active_role: string | undefined;
+    /** Field metadata from context */
+    metadata: FieldMetadataInput | undefined;
+    /** Settings from context */
+    settings: {
+        data_ok_mode?: 'checkbox' | 'multi_state';
+        data_ok_hidden_states?: any[];
+        notes_panel_style?: any;
+        notes_background_color?: string;
+        notes_save_mode?: any;
+        notes_mode?: 'controlled' | 'api';
+        on_data_ok_hidden?: any;
+        on_data_ok_protected?: any;
+    };
+    /** Chat config from context */
+    chat_config: {
+        group_id?: string;
+        api_base_url?: string;
+        timezone?: string;
+        read_only?: boolean;
+        log_polling?: boolean;
+    } | undefined;
+    /** Current user from context */
+    current_user: any;
+    /** Callbacks from context */
+    callbacks: {
+        on_data_ok_change?: (field_id: string, value: any) => void;
+        on_notes_change?: (field_id: string, notes: any) => void;
+        on_visibility_change?: (field_id: string, visibility: 'visible' | 'hidden') => void;
+        on_lock_change?: (field_id: string, locked: boolean) => void;
+        on_delete?: (field_id: string) => void;
+        on_skip_change?: (field_id: string, skipped: boolean) => void;
+        on_edit_elements?: (field_id: string, entity_type: 'field' | 'group') => void;
+    };
+}
+/**
+ * Build all props needed by UnifiedFieldControls for a field or group.
+ */
+export declare function use_field_control_props(input: UseFieldControlPropsInput): {
+    role_controls: Record<import("./types.js").ControlName, import("../../hazo_template_generator/types.js").RoleControlBehaviour> | null;
+    fallback_visibility: FallbackSettings;
+    fallback_enabled: FallbackSettings;
+    control_metadata: ControlMetadata;
+    control_callbacks: ControlCallbacks;
+    control_config: ControlConfig;
+};
+//# sourceMappingURL=use_field_control_props.d.ts.map

package/dist/components/shared/unified_field_controls/use_field_control_props.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use_field_control_props.d.ts","sourceRoot":"","sources":["../../../../src/components/shared/unified_field_controls/use_field_control_props.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAMH,OAAO,KAAK,EAAE,eAAe,EAAE,gBAAgB,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AACrG,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAElE,0BAA0B;AAC1B,MAAM,WAAW,yBAAyB;IACxC,yDAAyD;IACzD,YAAY,EAAE,OAAO,CAAC;IACtB,eAAe;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,2CAA2C;IAC3C,WAAW,EAAE,MAAM,CAAC;IACpB,qCAAqC;IACrC,WAAW,EAAE,OAAO,GAAG,OAAO,CAAC;IAC/B,mCAAmC;IACnC,eAAe,EAAE,GAAG,CAAC;IACrB,gCAAgC;IAChC,WAAW,EAAE,MAAM,GAAG,SAAS,CAAC;IAChC,kCAAkC;IAClC,QAAQ,EAAE,kBAAkB,GAAG,SAAS,CAAC;IACzC,4BAA4B;IAC5B,QAAQ,EAAE;QACR,YAAY,CAAC,EAAE,UAAU,GAAG,aAAa,CAAC;QAC1C,qBAAqB,CAAC,EAAE,GAAG,EAAE,CAAC;QAC9B,iBAAiB,CAAC,EAAE,GAAG,CAAC;QACxB,sBAAsB,CAAC,EAAE,MAAM,CAAC;QAChC,eAAe,CAAC,EAAE,GAAG,CAAC;QACtB,UAAU,CAAC,EAAE,YAAY,GAAG,KAAK,CAAC;QAClC,iBAAiB,CAAC,EAAE,GAAG,CAAC;QACxB,oBAAoB,CAAC,EAAE,GAAG,CAAC;KAC5B,CAAC;IACF,+BAA+B;IAC/B,WAAW,EAAE;QACX,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,SAAS,CAAC,EAAE,OAAO,CAAC;QACpB,WAAW,CAAC,EAAE,OAAO,CAAC;KACvB,GAAG,SAAS,CAAC;IACd,gCAAgC;IAChC,YAAY,EAAE,GAAG,CAAC;IAClB,6BAA6B;IAC7B,SAAS,EAAE;QACT,iBAAiB,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,KAAK,IAAI,CAAC;QAC3D,eAAe,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,KAAK,IAAI,CAAC;QACzD,oBAAoB,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,SAAS,GAAG,QAAQ,KAAK,IAAI,CAAC;QACpF,cAAc,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,KAAK,IAAI,CAAC;QAC7D,SAAS,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,IAAI,CAAC;QACvC,cAAc,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,KAAK,IAAI,CAAC;QAC9D,gBAAgB,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,WAAW,EAAE,OAAO,GAAG,OAAO,KAAK,IAAI,CAAC;KAC/E,CAAC;CACH;AAaD;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,yBAAyB;;;;;;;EAyFvE"}

package/dist/components/shared/unified_field_controls/use_field_control_props.js

@@ -0,0 +1,105 @@
+/**
+ * Shared hook for building UnifiedFieldControls props.
+ *
+ * Summary view duplicates these 6 useMemo blocks identically in both
+ * SummaryGroup and SummaryField. This hook consolidates them into one call.
+ */
+'use client';
+import { useMemo } from 'react';
+import { resolve_role_controls } from '../role_utils/index.js';
+/** The empty fallback settings (all false) */
+const EMPTY_FALLBACK = {
+    data_ok: false,
+    skip: false,
+    notes: false,
+    chat: false,
+    visibility: false,
+    lock: false,
+    delete: false,
+};
+/**
+ * Build all props needed by UnifiedFieldControls for a field or group.
+ */
+export function use_field_control_props(input) {
+    const { has_controls, field_id, field_label, entity_type, icons_behaviour, active_role, metadata, settings, chat_config, current_user, callbacks, } = input;
+    const role_controls = useMemo(() => {
+        if (!has_controls)
+            return null;
+        return resolve_role_controls(icons_behaviour, active_role);
+    }, [has_controls, icons_behaviour, active_role]);
+    const fallback_visibility = useMemo(() => {
+        if (!role_controls)
+            return EMPTY_FALLBACK;
+        return {
+            data_ok: role_controls.control_data_ok.visible,
+            skip: role_controls.control_skip.visible,
+            notes: role_controls.control_notes.visible,
+            chat: role_controls.control_chat.visible,
+            visibility: role_controls.control_visibility.visible,
+            lock: role_controls.control_lock.visible,
+            delete: role_controls.control_delete.visible,
+        };
+    }, [role_controls]);
+    const fallback_enabled = useMemo(() => {
+        if (!role_controls)
+            return EMPTY_FALLBACK;
+        return {
+            data_ok: role_controls.control_data_ok.enabled,
+            skip: role_controls.control_skip.enabled,
+            notes: role_controls.control_notes.enabled,
+            chat: role_controls.control_chat.enabled,
+            visibility: role_controls.control_visibility.enabled,
+            lock: role_controls.control_lock.enabled,
+            delete: role_controls.control_delete.enabled,
+        };
+    }, [role_controls]);
+    const control_metadata = useMemo(() => ({
+        data_ok: metadata?.data_ok,
+        locked: metadata?.locked,
+        deleted: metadata?.deleted,
+        visibility: metadata?.visibility,
+        skipped: metadata?.skipped,
+        notes: metadata?.notes,
+        has_chat_messages: metadata?.has_chat_messages,
+        chat_status: metadata?.chat_status,
+    }), [metadata]);
+    const control_callbacks = useMemo(() => ({
+        on_data_ok_change: (value) => callbacks.on_data_ok_change?.(field_id, value),
+        on_notes_change: (notes) => callbacks.on_notes_change?.(field_id, notes),
+        on_chat_click: () => { },
+        on_visibility_change: (visibility) => callbacks.on_visibility_change?.(field_id, visibility),
+        on_lock_change: (locked) => callbacks.on_lock_change?.(field_id, locked),
+        on_delete: () => callbacks.on_delete?.(field_id),
+        on_skip_change: (skipped) => callbacks.on_skip_change?.(field_id, skipped),
+        on_edit_elements: () => callbacks.on_edit_elements?.(field_id, entity_type),
+    }), [field_id, entity_type, callbacks]);
+    const control_config = useMemo(() => ({
+        data_ok_mode: settings.data_ok_mode,
+        data_ok_hidden_states: settings.data_ok_hidden_states,
+        chat_group_id: chat_config?.group_id,
+        chat_api_base_url: chat_config?.api_base_url,
+        chat_timezone: chat_config?.timezone,
+        chat_read_only: chat_config?.read_only,
+        chat_log_polling: chat_config?.log_polling,
+        current_user: current_user,
+        field_data_id: field_id,
+        label: field_label || field_id,
+        notes_panel_style: settings.notes_panel_style,
+        notes_background_color: settings.notes_background_color,
+        notes_save_mode: settings.notes_save_mode,
+        notes_mode: settings.notes_mode,
+        auto_actions: {
+            on_data_ok_hidden: settings.on_data_ok_hidden,
+            on_data_ok_protected: settings.on_data_ok_protected,
+        },
+    }), [settings, chat_config, current_user, field_id, field_label]);
+    return {
+        role_controls,
+        fallback_visibility,
+        fallback_enabled,
+        control_metadata,
+        control_callbacks,
+        control_config,
+    };
+}
+//# sourceMappingURL=use_field_control_props.js.map

package/dist/components/shared/unified_field_controls/use_field_control_props.js.map

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

package/dist/components/shared/use_base_form_field.d.ts

@@ -0,0 +1,190 @@
+/**
+ * Shared hook that extracts ALL common setup logic from form field components.
+ *
+ * Every form component (inputbox, textarea, checkbox, combo, radio, date)
+ * duplicates ~200 lines of identical setup: file state, validation,
+ * chat hook, visibility check, disabled state, additional entry logic,
+ * error merging, data_ok handler, and imperative handle.
+ *
+ * This hook consolidates all of that into a single reusable hook.
+ */
+import React from 'react';
+import { CollabFormFieldContainer, type CollabFormFieldBaseProps, type FileData, type NoteEntry } from '../hazo_collab_form_base.js';
+import type { DataOkState } from '../data_ok_multi_state.js';
+/** Props type for CollabFormFieldContainer (excluding children) */
+type ContainerPropsType = Omit<Parameters<typeof CollabFormFieldContainer>[0], 'children'>;
+/**
+ * Result returned by use_base_form_field
+ */
+export interface BaseFormFieldResult {
+    /** Ref for the underlying DOM element (input, textarea, button, etc.) */
+    component_ref: React.RefObject<any>;
+    /** Current files (controlled or internal) */
+    current_files: FileData[];
+    /** Internal file setter (for controlled/uncontrolled file state) */
+    set_internal_files: React.Dispatch<React.SetStateAction<FileData[]>>;
+    /** Combined display error (external error || validation error) */
+    display_error: string | undefined;
+    /** Setter for internal validation error */
+    set_validation_error: React.Dispatch<React.SetStateAction<string | null>>;
+    /** Whether the field should be disabled (chat active || locked || skipped) */
+    is_field_disabled: boolean;
+    /** Whether visibility === 'hidden' */
+    is_hidden: boolean;
+    /** Whether to return null (responder + hidden) */
+    should_hide: boolean;
+    /** Whether to show the add entry button */
+    show_add_entry: boolean;
+    /** Unified handler for data_ok changes (both checkbox and multi-state) */
+    handle_data_ok_unified_change: (value: boolean | DataOkState) => void;
+    /** Stable callback for files change (handles internal/controlled state) */
+    handle_files_change: (new_files: FileData[]) => void;
+    /** Final computed field ID */
+    field_id_final: string;
+    /** Chat icon click handler */
+    handle_chat_icon_click: () => void;
+    /** Chat close handler */
+    handle_chat_close: () => void;
+    /** Whether chat is currently open */
+    chat_is_open: boolean;
+    /** Whether chat is effectively disabled (hidden field, etc.) */
+    is_chat_effectively_disabled: boolean;
+    /** Container props for CollabFormFieldContainer */
+    container_props: ContainerPropsType;
+    /** Label props for CollabFormFieldLabel */
+    label_props: {
+        field_id_final: string;
+        label: string;
+        tooltip: any;
+        label_class_name?: string;
+        required?: boolean;
+        visibility?: 'visible' | 'hidden';
+        locked?: boolean;
+        label_actions?: React.ReactNode;
+    };
+    /** Controls props for UnifiedFieldControls */
+    controls_props: {
+        field_id: string;
+        icons_behaviour: any;
+        active_role: any;
+        metadata: {
+            data_ok: any;
+            skipped: boolean;
+            locked: boolean;
+            deleted: boolean;
+            visibility: 'visible' | 'hidden';
+            notes: NoteEntry[] | undefined;
+            chat_status: any;
+        };
+        callbacks: {
+            on_data_ok_change: (value: boolean | DataOkState) => void;
+            on_skip_change: ((skipped: boolean) => void) | undefined;
+            on_notes_change: ((notes: NoteEntry[]) => void) | undefined;
+            on_chat_click: () => void;
+            on_visibility_change: ((visibility: 'visible' | 'hidden') => void) | undefined;
+            on_lock_change: ((locked: boolean) => void) | undefined;
+            on_delete: (() => void) | undefined;
+        };
+        config: {
+            data_ok_mode: 'checkbox' | 'multi_state';
+            data_ok_hidden_states: DataOkState[] | undefined;
+            chat_group_id: string | undefined;
+            current_user: any;
+            field_data_id: string;
+            label: string;
+            chat_api_base_url: string | undefined;
+            chat_timezone: string | undefined;
+            chat_read_only: boolean | undefined;
+            notes_panel_style: any;
+            notes_background_color: string | undefined;
+            notes_save_mode: any;
+        };
+        fallback_visibility: {
+            data_ok: boolean;
+            skip: boolean;
+            notes: boolean;
+            chat: boolean;
+            visibility: boolean;
+            lock: boolean;
+            delete: boolean;
+        };
+        fallback_enabled: {
+            data_ok: boolean;
+            skip: boolean;
+            notes: boolean;
+            chat: boolean;
+            visibility: boolean;
+            lock: boolean;
+            delete: boolean;
+        };
+    };
+    /** File upload section props */
+    file_upload_props: {
+        field_id_final: string;
+        accept_files_public: boolean;
+        accept_files_private: boolean;
+        files_dir?: string;
+        max_size?: number;
+        min_files?: number;
+        max_files?: number;
+        file_accept?: string;
+        file_processor?: any;
+        file_validator?: any;
+        files: FileData[];
+        on_files_change: (new_files: FileData[]) => void;
+        component_ref: React.RefObject<any>;
+        private_files_permission?: string;
+        can_access_private_files?: boolean;
+        private_files?: FileData[];
+        on_private_files_change?: (files: FileData[]) => void;
+    };
+    /** Reference tag props */
+    reference_tag_props: {
+        reference_value: any;
+        reference_label: string | undefined;
+        reference_tag_background_color: string | undefined;
+    };
+    /** Error display props */
+    error_props: {
+        field_id_final: string;
+        error: string | undefined;
+        error_class_name: string | undefined;
+    };
+    /** Additional entry props */
+    entry_props: {
+        show_add_entry: boolean;
+        label: string;
+        field_id: string;
+        on_add_entry: ((field_id: string) => void) | undefined;
+        is_additional_entry: boolean | undefined;
+        on_delete_entry: ((field_id: string) => void) | undefined;
+        action_buttons_borderless: boolean | undefined;
+    };
+    /** User role */
+    user_role: 'author' | 'responder';
+    /** Width class name for field container */
+    field_width_class_name: string | undefined;
+    /** Whether field is locked */
+    locked: boolean;
+    /** Whether field is skipped */
+    skipped: boolean;
+    /** Class name */
+    className: string | undefined;
+}
+/**
+ * Hook that consolidates all common form field component setup.
+ *
+ * @param props - The full component props (extends CollabFormFieldBaseProps)
+ * @param ref - The forwarded ref
+ * @param element_type_name - Used for display name / typing context only
+ */
+export declare function use_base_form_field<TRef>(props: CollabFormFieldBaseProps & {
+    disabled?: boolean;
+    className?: string;
+    id?: string;
+    files?: FileData[];
+    on_files_change?: (files: FileData[]) => void;
+    [key: string]: any;
+}, ref: React.ForwardedRef<TRef>): BaseFormFieldResult;
+export {};
+//# sourceMappingURL=use_base_form_field.d.ts.map

package/dist/components/shared/use_base_form_field.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use_base_form_field.d.ts","sourceRoot":"","sources":["../../../src/components/shared/use_base_form_field.ts"],"names":[],"mappings":"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"}