@controleonline/ui-default 1.0.272 → 1.0.274

package/src/react/components/table/DefaultTableView.js

@@ -0,0 +1,118 @@
+import React from 'react';
+import { Modal, Text, TouchableOpacity, View } from 'react-native';
+import Icon from 'react-native-vector-icons/Feather';
+import DefaultTableBody from './DefaultTableBody';
+import DefaultTableFooter from './DefaultTableFooter';
+import DefaultTableToolbar from './DefaultTableToolbar';
+import DefaultForm from '../form/DefaultForm';
+import styles from './DefaultTable.styles';
+
+export default function DefaultTableView({
+  tablePanelBorderColor,
+  themeColors,
+  showToolbar,
+  storeName,
+  showToolbarActions,
+  showToolbarControls,
+  shouldRenderBottomAddButton,
+  resolvedAddLabel,
+  floatingAddBackgroundColor,
+  resolvedOnAdd,
+  floatingAddIconColor,
+  shouldRenderFloatingAddButton,
+  closeCreateForm,
+  isCreateFormOpen,
+  resolvedActions,
+  columnsForTable,
+  getOptionsForColumn,
+  handleDefaultCreateSaved,
+  requestParamsSeed
+}) {
+  return (
+    <View
+      style={[
+        styles.wrap,
+        {
+          borderWidth: tablePanelBorderColor ? 1 : 0,
+          borderColor: tablePanelBorderColor,
+          backgroundColor: themeColors.panelBackground,
+        },
+      ]}
+    >
+      {showToolbar !== false ? (
+        <DefaultTableToolbar
+          storeName={storeName}
+          showToolbarActions={showToolbarActions}
+          showToolbarControls={showToolbarControls}
+        />
+      ) : null}
+      <DefaultTableBody storeName={storeName} />
+      <DefaultTableFooter storeName={storeName} />
+      {shouldRenderBottomAddButton ? (
+        <View style={styles.bottomAddBar}>
+          <TouchableOpacity
+            accessibilityRole="button"
+            accessibilityLabel={resolvedAddLabel}
+            activeOpacity={0.84}
+            style={[
+              styles.bottomAddButton,
+              { backgroundColor: floatingAddBackgroundColor },
+            ]}
+            onPress={resolvedOnAdd}
+          >
+            <Icon name="plus" size={18} color={floatingAddIconColor} />
+            <Text style={[styles.bottomAddText, { color: floatingAddIconColor }]}>
+              {resolvedAddLabel}
+            </Text>
+          </TouchableOpacity>
+        </View>
+      ) : null}
+      {shouldRenderFloatingAddButton ? (
+        <TouchableOpacity
+          accessibilityRole="button"
+          accessibilityLabel={resolvedAddLabel}
+          activeOpacity={0.84}
+          style={[
+            styles.floatingAddButton,
+            { backgroundColor: floatingAddBackgroundColor },
+          ]}
+          onPress={resolvedOnAdd}
+        >
+          <Icon name="plus" size={24} color={floatingAddIconColor} />
+        </TouchableOpacity>
+      ) : null}
+      <Modal
+        animationType="fade"
+        onRequestClose={closeCreateForm}
+        transparent
+        visible={isCreateFormOpen}
+      >
+        <View style={styles.modalOverlay}>
+          <View style={styles.modalCard}>
+            <View style={styles.modalHeader}>
+              <Text style={styles.modalTitle}>{resolvedAddLabel}</Text>
+              <TouchableOpacity
+                accessibilityRole="button"
+                accessibilityLabel={global.t?.t(storeName, 'button', 'cancel') || 'Cancelar'}
+                onPress={closeCreateForm}
+                style={styles.modalCloseButton}
+              >
+                <Icon name="x" size={16} color={themeColors.textPrimary || '#0F172A'} />
+              </TouchableOpacity>
+            </View>
+            <DefaultForm
+              actions={resolvedActions}
+              columns={columnsForTable}
+              getOptionsForColumn={getOptionsForColumn}
+              mode="create"
+              onCancel={closeCreateForm}
+              onSaved={handleDefaultCreateSaved}
+              row={requestParamsSeed}
+              storeName={storeName}
+            />
+          </View>
+        </View>
+      </Modal>
+    </View>
+  );
+}

package/src/react/components/upload/DefaultUpload.js

@@ -28,8 +28,6 @@ const DefaultUpload = ({
   attachments = [],
   entityId,
   companyId,
-  company = null,
-  showAttachmentActions = true,
   context = 'products',
   libraryContexts = DEFAULT_LIBRARY_CONTEXTS,
   fileStoreName = 'file',
@@ -162,17 +160,10 @@ const DefaultUpload = ({
     setCoverId(coverRelationId || null);
   }, [coverRelationId]);
 
-  const peopleStoreForMedia = useStore('people');
-  const peopleActionsForLibrary = (() => {
-    const fromRelation =
-      relationStoreName === 'people' && typeof relationActions?.getPeopleMedia === 'function'
-        ? relationActions
-        : null;
-    if (fromRelation) return fromRelation;
-    const fromPeople = peopleStoreForMedia?.actions;
-    if (typeof fromPeople?.getPeopleMedia === 'function') return fromPeople;
-    return null;
-  })();
+  const peopleActionsForLibrary =
+    relationStoreName === 'people' && typeof relationActions?.getPeopleMedia === 'function'
+      ? relationActions
+      : null;
 
   const loadLibrary = useCallback(async (extraFiles = []) => {
     setLibraryLoading(true);
@@ -186,26 +177,7 @@ const DefaultUpload = ({
         peopleActions: peopleActionsForLibrary,
         knownFileIds: resolvedKnownIds,
       });
-      const preferImageMeta = String(fileType || '').toLowerCase() === 'image';
-      const withMeta = (list) =>
-        (Array.isArray(list) ? list : []).map(item => {
-          if (!item || typeof item !== 'object') return item;
-          const id = extractFileId(item);
-          if (!id) return item;
-          return {
-            ...item,
-            id: item.id || id,
-            '@id': item['@id'] || `/files/${id}`,
-            context: item.context || context || 'people_media',
-            fileType: item.fileType || item.mimeType || (preferImageMeta ? 'image' : item.fileType),
-            fileName: item.fileName || item.name || item.originalName || `Arquivo ${id}`,
-          };
-        });
-      setLibraryFiles(
-        dedupeFiles(
-          withMeta([...(Array.isArray(extraFiles) ? extraFiles : []), ...files]),
-        ),
-      );
+      setLibraryFiles(dedupeFiles([...(Array.isArray(extraFiles) ? extraFiles : []), ...files]));
     } catch (e) {
       setLibraryError(e?.message || 'Falha ao carregar biblioteca de arquivos.');
       setLibraryFiles(dedupeFiles(extraFiles));
@@ -400,8 +372,6 @@ const DefaultUpload = ({
       emptyAttachmentsLabel={emptyAttachmentLabel}
       status={status}
       error={error}
-      fileType={fileType}
-      company={company || (companyId ? {id: companyId} : null)}
     />
   );
 
@@ -427,7 +397,7 @@ const DefaultUpload = ({
       handleRemove={handleRemove}
       buttonPalette={buttonPalette}
       managerModal={managerModal}
-      company={company || (companyId ? {id: companyId} : null)}
+      company={company}
       showAttachmentActions={showAttachmentActions}
     />
   );

package/src/react/components/upload/DefaultUpload.styles.js

@@ -63,7 +63,7 @@ export const defaultUploadStyles = {
   modalList: {maxHeight: 520},
   libraryGrid: {flexDirection: 'row', flexWrap: 'wrap', gap: 10, paddingHorizontal: 14, paddingBottom: 18},
   fileCard: {
-    width: 176,
+    width: 320,
     borderWidth: 1,
     borderColor: '#E2E8F0',
     borderRadius: 8,
@@ -71,7 +71,7 @@ export const defaultUploadStyles = {
     overflow: 'hidden',
   },
   fileCardAttached: {borderColor: '#86EFAC', backgroundColor: '#F0FDF4'},
-  fileThumb: {height: 112, backgroundColor: '#F1F5F9', alignItems: 'center', justifyContent: 'center'},
+  fileThumb: {width: 320, height: 320, backgroundColor: '#F1F5F9', alignItems: 'center', justifyContent: 'center'},
   fileThumbFallback: {alignItems: 'center', justifyContent: 'center', gap: 6, height: '100%', width: '100%', backgroundColor: '#EEF2FF'},
   fileExtBadge: {
     color: '#312E81',
@@ -130,9 +130,9 @@ export const defaultUploadStyles = {
   attachmentsEmpty: {borderWidth: 1, borderColor: '#ddd', borderRadius: 8, padding: 10},
   attachmentsEmptyText: {color: '#666'},
   attachmentsList: {flexDirection: 'row', gap: 10},
-  attachmentCard: {width: 170, borderWidth: 1, borderColor: '#ddd', borderRadius: 8, padding: 8, backgroundColor: '#fff'},
-  attachmentThumb: {height: 120, backgroundColor: '#f5f5f5', borderRadius: 6, overflow: 'hidden', marginBottom: 8, alignItems: 'center', justifyContent: 'center'},
-  attachmentImage: {width: '100%', height: '100%'},
+  attachmentCard: {width: 320, borderWidth: 1, borderColor: '#ddd', borderRadius: 8, padding: 0, overflow: 'hidden', backgroundColor: '#fff'},
+  attachmentThumb: {width: 320, height: 320, backgroundColor: '#f5f5f5', overflow: 'hidden', alignItems: 'center', justifyContent: 'center'},
+  attachmentImage: {width: 320, height: 320},
   attachmentActionsRow: {flexDirection: 'row', justifyContent: 'center', alignItems: 'center', gap: 8, marginTop: 2},
   attachmentIconButton: {width: 36, height: 36, borderRadius: 8, alignItems: 'center', justifyContent: 'center'},
   attachmentRemoveButton: {backgroundColor: '#b00020', paddingVertical: 6, borderRadius: 4},

package/src/react/components/upload/DefaultUploadAttachmentsList.js

@@ -74,14 +74,22 @@ export default function DefaultUploadAttachmentsList({
               return (
                 <View
                   key={row.id || fileId || index}
-                  style={styles.attachmentCard}>
-                  <View style={styles.attachmentThumb}>
+                  style={[
+                    styles.attachmentCard,
+                    // app-community#813: card principal 320x320
+                    {width: 320, padding: 0, overflow: 'hidden'},
+                  ]}>
+                  <View
+                    style={[
+                      styles.attachmentThumb,
+                      {width: 320, height: 320, marginBottom: 0},
+                    ]}>
                     {file ? (
                       <DefaultFile
                         file={file}
                         company={company}
                         resizeMode="cover"
-                        style={styles.attachmentImage}
+                        style={{width: 320, height: 320}}
                       />
                     ) : null}
                   </View>

package/src/react/hooks/usePostalCodeLookup.js

@@ -1,6 +1,8 @@
 import {useCallback, useEffect, useRef, useState} from 'react';
 import {lookupPostalCode, listStates} from '../services/addressGeo';
 import {
+  clearPostalCodeDerivedFields,
+  isGeocodeMiss,
   mergePostalCodeData,
   onlyDigits,
 } from '../services/addressFormUtils';
@@ -9,7 +11,8 @@ const DEBOUNCE_MS = 450;
 
 /**
  * CEP lookup with debounce (8 digits), race-token protection and loading/error state.
- * Never overwrites number/complement/nickname (via mergePostalCodeData).
+ * Clears number on lookup; clears derived address/coords on failure (#746).
+ * Preserves complement/nickname.
  */
 export default function usePostalCodeLookup({
   formCep,
@@ -20,6 +23,7 @@ export default function usePostalCodeLookup({
 }) {
   const [loadingCep, setLoadingCep] = useState(false);
   const [cepError, setCepError] = useState(null);
+  const [geocodeMiss, setGeocodeMiss] = useState(false);
   const requestIdRef = useRef(0);
   const debounceRef = useRef(null);
   const lastRequestedRef = useRef('');
@@ -35,12 +39,14 @@ export default function usePostalCodeLookup({
       lastRequestedRef.current = digits;
       setLoadingCep(true);
       setCepError(null);
+      setGeocodeMiss(false);
 
       try {
         const data = await lookupPostalCode(digits);
         if (requestId !== requestIdRef.current) {
           return null; // stale response
         }
+        setGeocodeMiss(isGeocodeMiss(data));
         setForm(prev => {
           const next = mergePostalCodeData(
             {...prev, cep: digits},
@@ -76,6 +82,12 @@ export default function usePostalCodeLookup({
           e?.response?.data?.detail ||
           'CEP inválido ou serviço indisponível';
         setCepError(message);
+        // CEP não encontrado: zera residual de endereço/coords/número (#746)
+        setForm(prev => {
+          const next = clearPostalCodeDerivedFields(prev);
+          onFormChange?.(next);
+          return next;
+        });
         return null;
       } finally {
         if (requestId === requestIdRef.current) {
@@ -138,6 +150,8 @@ export default function usePostalCodeLookup({
     loadingCep,
     cepError,
     setCepError,
+    geocodeMiss,
+    setGeocodeMiss,
     onCepBlur,
     runLookup,
     cancelPending,

package/src/react/services/addressFormUtils.js

@@ -1,20 +1,5 @@
 const onlyDigits = value => String(value || '').replace(/\D+/g, '');
 
-/** Keep at most 8 CEP digits (Brazilian postal code). */
-export const normalizeCepDigits = value => onlyDigits(value).slice(0, 8);
-
-/**
- * Display mask #####-### (hyphen is visual only; max 8 digits).
- * @example formatCepMask('01310100') => '01310-100'
- */
-export const formatCepMask = value => {
-  const digits = normalizeCepDigits(value);
-  if (digits.length <= 5) {
-    return digits;
-  }
-  return `${digits.slice(0, 5)}-${digits.slice(5)}`;
-};
-
 export const emptyAddressForm = {
   nickname: '',
   cep: '',
@@ -73,15 +58,21 @@ export function hasAddressText(form) {
 }
 
 export function hasCoordinates(form) {
+  const lat = Number(form?.latitude);
+  const lng = Number(form?.longitude);
+  // 0,0 is the API/entity default for "no coordinates"
   return (
-    Number.isFinite(Number(form?.latitude)) &&
-    Number.isFinite(Number(form?.longitude))
+    Number.isFinite(lat) &&
+    Number.isFinite(lng) &&
+    !(Math.abs(lat) < 0.000001 && Math.abs(lng) < 0.000001)
   );
 }
 
 /**
  * Merge postal-code API payload into form state.
- * Always preserves number, complement and nickname (manual fields).
+ * Preserves complement and nickname (manual).
+ * On CEP lookup (preserveFilledFields=false): clears number and replaces
+ * auto-filled address/coords — no residual from previous CEP (#746).
  * When preserveFilledFields is true, also keeps non-empty street/city/etc.
  */
 export function mergePostalCodeData(
@@ -89,36 +80,88 @@ export function mergePostalCodeData(
   data,
   {preserveFilledFields = false} = {},
 ) {
-  const keep = (key, nextValue) =>
-    preserveFilledFields && String(prev[key] || '').trim()
-      ? prev[key]
-      : nextValue || prev[key] || '';
+  const pick = (key, nextValue) => {
+    if (preserveFilledFields && String(prev[key] || '').trim()) {
+      return prev[key];
+    }
+    if (
+      nextValue !== undefined &&
+      nextValue !== null &&
+      String(nextValue).trim() !== ''
+    ) {
+      return nextValue;
+    }
+    // Fresh CEP lookup must not keep residual street/city/etc.
+    if (!preserveFilledFields) {
+      return nextValue == null ? '' : String(nextValue);
+    }
+    return prev[key] || '';
+  };
 
   const countryRaw = data?.country;
   const isBrazil =
     countryRaw === 'Brasil' || countryRaw === 'Brazil' || countryRaw === 'BR';
 
+  const latitude =
+    data?.latitude !== undefined
+      ? data.latitude
+      : data?.map?.latitude !== undefined
+        ? data.map.latitude
+        : preserveFilledFields
+          ? prev.latitude
+          : null;
+  const longitude =
+    data?.longitude !== undefined
+      ? data.longitude
+      : data?.map?.longitude !== undefined
+        ? data.map.longitude
+        : preserveFilledFields
+          ? prev.longitude
+          : null;
+
   return {
     ...prev,
-    // Manual fields never overwritten by lookup
-    number: prev.number,
+    // Número do imóvel anterior não se aplica ao novo CEP (#746)
+    number: preserveFilledFields ? prev.number : '',
     complement: prev.complement,
     nickname: prev.nickname,
-    cep: normalizeCepDigits(data?.cep || prev.cep),
-    street: keep('street', data?.street),
-    district: keep('district', data?.district),
-    city: keep('city', data?.city),
-    uf: keep('uf', data?.uf || data?.state),
-    stateName: keep('stateName', data?.state),
-    countryCode: isBrazil ? 'BR' : countryRaw || prev.countryCode,
+    cep: onlyDigits(data?.cep || prev.cep),
+    street: pick('street', data?.street),
+    district: pick('district', data?.district),
+    city: pick('city', data?.city),
+    uf: pick('uf', data?.uf || data?.state),
+    stateName: pick('stateName', data?.state),
+    countryCode: isBrazil ? 'BR' : countryRaw || prev.countryCode || 'BR',
     countryName: isBrazil
       ? 'Brazil'
-      : countryRaw || prev.countryName,
-    latitude: data?.latitude ?? data?.map?.latitude ?? prev.latitude,
-    longitude: data?.longitude ?? data?.map?.longitude ?? prev.longitude,
-    mapStaticUrl: data?.map?.staticUrl || prev.mapStaticUrl || null,
-    facadeUrl: data?.facade?.streetViewUrl || prev.facadeUrl || null,
-    provider: data?.provider || prev.provider || null,
+      : countryRaw || prev.countryName || 'Brazil',
+    latitude,
+    longitude,
+    mapStaticUrl: preserveFilledFields
+      ? data?.map?.staticUrl || prev.mapStaticUrl || null
+      : data?.map?.staticUrl || null,
+    facadeUrl: preserveFilledFields
+      ? data?.facade?.streetViewUrl || prev.facadeUrl || null
+      : data?.facade?.streetViewUrl || null,
+    provider: data?.provider || (preserveFilledFields ? prev.provider : null) || null,
+  };
+}
+
+/** Clear fields derived from a previous CEP when lookup fails (#746). */
+export function clearPostalCodeDerivedFields(prev) {
+  return {
+    ...prev,
+    number: '',
+    street: '',
+    district: '',
+    city: '',
+    uf: '',
+    stateName: '',
+    latitude: null,
+    longitude: null,
+    mapStaticUrl: null,
+    facadeUrl: null,
+    provider: null,
   };
 }
 
@@ -157,16 +200,39 @@ export function buildMapMarkerPayload(form) {
 
 export {onlyDigits};
 
+export const GEOCODE_MISS_MESSAGE =
+  'Não foi possível obter a localização no mapa para este endereço. Você pode ajustar latitude e longitude manualmente.';
+
 export function parseOptionalCoordinate(value) {
   if (value === null || value === undefined || value === '') {
     return null;
   }
 
-  const parsed = Number(String(value).trim());
+  const parsed = Number(String(value).trim().replace(',', '.'));
 
   return Number.isFinite(parsed) ? parsed : null;
 }
 
+/** True when CEP/address text arrived but Nominatim (or API) left coords empty. */
+export function isGeocodeMiss(data) {
+  if (!data || typeof data !== 'object') {
+    return false;
+  }
+  const hasText = [
+    data.street,
+    data.district,
+    data.city,
+    data.uf,
+    data.state,
+  ].some(value => String(value || '').trim().length > 0);
+  if (!hasText) {
+    return false;
+  }
+  const lat = data.latitude ?? data.map?.latitude;
+  const lon = data.longitude ?? data.map?.longitude;
+  return !Number.isFinite(Number(lat)) || !Number.isFinite(Number(lon));
+}
+
 export function getCurrentCoordinates() {
   return new Promise(resolve => {
     const geolocation =

package/src/react/services/addressGeo.js

@@ -151,7 +151,9 @@ export async function lookupPostalCode(cep) {
       const viaCep = await lookupViaCep(digits);
       payload = mergePostalLookupPayload(payload, viaCep, viaCep.provider);
     } catch (e) {
-      if (apiError && isPostalLookupIncomplete(payload)) {
+      // ViaCEP "CEP não encontrado" (or HTTP error) must surface so the form
+      // clears residual address/coords/number (#746) — do not swallow.
+      if (isPostalLookupIncomplete(payload)) {
         throw new Error(
           e?.message ||
             apiError?.message ||
@@ -176,11 +178,12 @@ export async function lookupPostalCode(cep) {
     }
   }
 
-  if (isPostalLookupIncomplete(payload) && apiError && !hasText(payload.street)) {
+  // No usable address text after all providers → treat as not found (#746)
+  if (!hasText(payload.street) && !hasText(payload.city)) {
     throw new Error(
       apiError?.message ||
         apiError?.response?.data?.detail ||
-        'CEP inválido ou serviço indisponível',
+        'CEP não encontrado',
     );
   }
 

package/src/react/utils/tableVisibleColumnsPreferences.js

@@ -3,12 +3,45 @@ export const TABLE_VIEW_MODE_PREFERENCES_KEY = 'viewMode';
 export const TABLE_SORT_PREFERENCES_KEY = 'sort';
 export const TABLE_FILTER_PREFERENCES_KEY = 'filters';
 export const DEFAULT_TABLE_PREFERENCES_STORAGE_KEY = 'default-table';
+export const REQUIRED_VISIBLE_COLUMN_KEYS = ['id'];
 
 const isPlainObject = value =>
   !!value && typeof value === 'object' && !Array.isArray(value);
 
 const getColumnKey = column => column?.key || column?.name || '';
 
+const normalizeColumnKey = value => String(value || '').trim().toLowerCase();
+
+export const isRequiredVisibleColumn = column => {
+  const key = normalizeColumnKey(getColumnKey(column));
+  if (!key) {
+    return false;
+  }
+
+  if (column?.required === true || column?.hideable === false) {
+    return true;
+  }
+
+  return REQUIRED_VISIBLE_COLUMN_KEYS.includes(key);
+};
+
+export const isRequiredVisibleColumnKey = (key, columns = []) => {
+  const normalizedKey = normalizeColumnKey(key);
+  if (!normalizedKey) {
+    return false;
+  }
+
+  const column = (Array.isArray(columns) ? columns : []).find(
+    item => normalizeColumnKey(getColumnKey(item)) === normalizedKey,
+  );
+
+  if (column) {
+    return isRequiredVisibleColumn(column);
+  }
+
+  return REQUIRED_VISIBLE_COLUMN_KEYS.includes(normalizedKey);
+};
+
 const normalizePreferenceSegment = value =>
   String(value || '')
     .trim()
@@ -141,11 +174,41 @@ export const buildDefaultVisibleColumns = columns =>
   (Array.isArray(columns) ? columns : []).reduce((accumulator, column) => {
     const key = getColumnKey(column);
     if (key) {
-      accumulator[key] = column?.visible !== false;
+      accumulator[key] = isRequiredVisibleColumn(column)
+        ? true
+        : column?.visible !== false;
     }
     return accumulator;
   }, {});
 
+const enforceRequiredVisibleColumns = (columns = [], visibleColumns = {}) => {
+  const nextVisibleColumns = {...visibleColumns};
+  const columnList = Array.isArray(columns) ? columns : [];
+
+  columnList.forEach(column => {
+    const key = getColumnKey(column);
+    if (key && isRequiredVisibleColumn(column)) {
+      nextVisibleColumns[key] = true;
+    }
+  });
+
+  const hasVisibleColumn = Object.keys(nextVisibleColumns).some(
+    key => nextVisibleColumns[key] !== false,
+  );
+
+  if (!hasVisibleColumn) {
+    const fallbackColumn =
+      columnList.find(column => isRequiredVisibleColumn(column)) ||
+      columnList.find(column => getColumnKey(column));
+    const fallbackKey = getColumnKey(fallbackColumn);
+    if (fallbackKey) {
+      nextVisibleColumns[fallbackKey] = true;
+    }
+  }
+
+  return nextVisibleColumns;
+};
+
 export const sanitizeVisibleColumnsPreference = ({
   columns = [],
   visibleColumns = null,
@@ -153,16 +216,34 @@ export const sanitizeVisibleColumnsPreference = ({
   const defaultVisibleColumns = buildDefaultVisibleColumns(columns);
 
   if (!isPlainObject(visibleColumns)) {
-    return defaultVisibleColumns;
+    return enforceRequiredVisibleColumns(columns, defaultVisibleColumns);
   }
 
-  return Object.keys(defaultVisibleColumns).reduce((accumulator, key) => {
+  const sanitized = Object.keys(defaultVisibleColumns).reduce((accumulator, key) => {
     accumulator[key] =
       typeof visibleColumns[key] === 'boolean'
         ? visibleColumns[key]
         : defaultVisibleColumns[key];
     return accumulator;
   }, {});
+
+  return enforceRequiredVisibleColumns(columns, sanitized);
+};
+
+export const canHideVisibleColumn = ({
+  columns = [],
+  fieldName = '',
+  visibleColumns = {},
+} = {}) => {
+  if (isRequiredVisibleColumnKey(fieldName, columns)) {
+    return false;
+  }
+
+  const visibleCount = Object.keys(visibleColumns || {}).filter(
+    key => visibleColumns[key] !== false,
+  ).length;
+
+  return visibleCount > 1;
 };
 
 export const sanitizeTableFiltersPreference = ({