From 8552ac4e7b37fc997dea078579f93c02f0d9e5eb Mon Sep 17 00:00:00 2001
From: Muhammed Mustafa <mustafa@nocodb.com>
Date: Fri, 22 Dec 2023 16:03:40 +0000
Subject: [PATCH 01/17] fix: Formula revamp

---
 .../smartsheet/column/EditOrAdd.vue           |   1 +
 .../smartsheet/column/FormulaOptions.vue      | 155 ++++++++++++------
 2 files changed, 106 insertions(+), 50 deletions(-)

diff --git a/packages/nc-gui/components/smartsheet/column/EditOrAdd.vue b/packages/nc-gui/components/smartsheet/column/EditOrAdd.vue
index 5f6c190554..e8d74b1959 100644
--- a/packages/nc-gui/components/smartsheet/column/EditOrAdd.vue
+++ b/packages/nc-gui/components/smartsheet/column/EditOrAdd.vue
@@ -225,6 +225,7 @@ if (props.fromTableExplorer) {
       'w-[400px]': !props.embedMode,
       '!w-146': isTextArea(formState) && formState.meta?.richMode,
       '!w-[600px]': formState.uidt === UITypes.Formula && !props.embedMode,
+      'overflow-visible': formState.uidt === UITypes.Formula,
       '!w-[500px]': formState.uidt === UITypes.Attachment && !props.embedMode && !appInfo.ee,
       'shadow-lg border-1 border-gray-200 shadow-gray-300 rounded-xl p-6': !embedMode,
     }"
diff --git a/packages/nc-gui/components/smartsheet/column/FormulaOptions.vue b/packages/nc-gui/components/smartsheet/column/FormulaOptions.vue
index e52df87238..203a37a57b 100644
--- a/packages/nc-gui/components/smartsheet/column/FormulaOptions.vue
+++ b/packages/nc-gui/components/smartsheet/column/FormulaOptions.vue
@@ -55,6 +55,8 @@ const supportedColumns = computed(
 )
 const { getMeta } = useMetas()
 
+const suggestionPreviewed = ref<Record<any, string> | undefined>()
+
 const validators = {
   formula_raw: [
     {
@@ -95,6 +97,8 @@ const sugListRef = ref()
 
 const sugOptionsRef = ref<(typeof AntListItem)[]>([])
 
+const variableListRef = ref<(typeof AntListItem)[]>([])
+
 const wordToComplete = ref<string | undefined>('')
 
 const selected = ref(0)
@@ -196,6 +200,13 @@ function handleInput() {
   suggestion.value = acTree.value
     .complete(wordToComplete.value)
     ?.sort((x: Record<string, any>, y: Record<string, any>) => sortOrder[x.type] - sortOrder[y.type])
+
+  if (suggestion.value.length > 0 && suggestion.value[0].type !== 'column') {
+    suggestionPreviewed.value = suggestion.value[0]
+  } else {
+    suggestionPreviewed.value = undefined
+  }
+
   if (!isCurlyBracketBalanced()) {
     suggestion.value = suggestion.value.filter((v) => v.type === 'column')
   }
@@ -256,7 +267,24 @@ onMounted(() => {
 </script>
 
 <template>
-  <div class="formula-wrapper">
+  <div class="formula-wrapper relative">
+    <div
+      v-if="suggestionPreviewed && suggestionPreviewed.type === 'function'"
+      class="absolute -left-91 w-84 top-0 bg-white z-10 p-3 border-1 shadow-md rounded-xl"
+    >
+      <div class="flex flex-row w-full justify-between pb-1 border-b-1">
+        <div class="font-semibold text-base">{{ suggestionPreviewed.text }}</div>
+        <NcButton type="text" size="small" @click="suggestionPreviewed = undefined">
+          <GeneralIcon icon="close" />
+        </NcButton>
+      </div>
+      <div class="text-gray-500 uppercase text-xs mt-3 mb-1">Syntax</div>
+      <div class="bg-gray-800 text-white rounded-md py-1 px-2">{{ suggestionPreviewed.syntax }}</div>
+      <div class="text-gray-500 uppercase text-xs mt-3 mb-1">Examples</div>
+      <div v-for="example of suggestionPreviewed.examples" :key="example" class="bg-gray-100 rounded-md py-1 px-2 mb-1">
+        {{ example }}
+      </div>
+    </div>
     <a-form-item v-bind="validateInfos.formula_raw" :label="$t('datatype.Formula')">
       <!-- <GeneralIcon
         v-if="isEeUI"
@@ -294,55 +322,82 @@ onMounted(() => {
       </a>
     </div>
 
-    <div class="h-[250px] overflow-auto scrollbar-thin-primary">
-      <a-list ref="sugListRef" :data-source="suggestion" :locale="{ emptyText: $t('msg.formula.noSuggestedFormulaFound') }">
-        <template #renderItem="{ item, index }">
-          <a-list-item
-            :ref="
-              (el) => {
-                sugOptionsRef[index] = el
-              }
-            "
-            class="cursor-pointer"
-            @click.prevent.stop="appendText(item)"
-          >
-            <a-list-item-meta>
-              <template #title>
-                <div class="flex">
-                  <a-col :span="6">
-                    <span class="prose-sm text-gray-600">{{ item.text }}</span>
-                  </a-col>
-
-                  <a-col :span="18">
-                    <div v-if="item.type === 'function'" class="text-xs text-gray-500">
-                      {{ item.description }} <br /><br />
-                      {{ $t('labels.syntax') }}: <br />
-                      {{ item.syntax }} <br /><br />
-                      {{ $t('labels.examples') }}: <br />
-
-                      <div v-for="(example, idx) of item.examples" :key="idx">
-                        <div>({{ idx + 1 }}): {{ example }}</div>
-                      </div>
-                    </div>
-
-                    <div v-if="item.type === 'column'" class="float-right mr-5 -mt-2">
-                      <a-badge-ribbon :text="item.uidt" color="gray" />
-                    </div>
-                  </a-col>
-                </div>
-              </template>
-
-              <template #avatar>
-                <component :is="iconMap.function" v-if="item.type === 'function'" class="text-lg" />
-
-                <component :is="iconMap.calculator" v-if="item.type === 'op'" class="text-lg" />
-
-                <component :is="item.icon" v-if="item.type === 'column'" class="text-lg" />
-              </template>
-            </a-list-item-meta>
-          </a-list-item>
-        </template>
-      </a-list>
+    <div ref="sugListRef" class="h-[250px] overflow-auto nc-scrollbar-md">
+      <template v-if="suggestedFormulas.length > 0">
+        <div class="rounded-t-lg border-1 bg-gray-50 px-3 py-1 uppercase text-gray-600 text-xs">Formulas</div>
+
+        <a-list
+          :data-source="suggestedFormulas"
+          :locale="{ emptyText: $t('msg.formula.noSuggestedFormulaFound') }"
+          class="border-1 border-t-0 rounded-b-lg !mb-4"
+        >
+          <template #renderItem="{ item, index }">
+            <a-list-item
+              :ref="
+                (el) => {
+                  sugOptionsRef[index] = el
+                }
+              "
+              class="cursor-pointer"
+              @click.prevent.stop="appendText(item)"
+              @mouseenter="suggestionPreviewed = item"
+            >
+              <a-list-item-meta>
+                <template #title>
+                  <div class="flex">
+                    <a-col :span="6">
+                      <span class="prose-sm text-gray-600">{{ item.text }}</span>
+                    </a-col>
+                  </div>
+                </template>
+              </a-list-item-meta>
+            </a-list-item>
+          </template>
+        </a-list>
+      </template>
+
+      <template v-if="variableList.length > 0">
+        <div class="rounded-t-lg border-1 bg-gray-50 px-3 py-1 uppercase text-gray-600 text-xs">Fields</div>
+
+        <a-list
+          ref="variableListRef"
+          :data-source="variableList"
+          :locale="{ emptyText: $t('msg.formula.noSuggestedFormulaFound') }"
+          class="border-1 border-t-0 rounded-b-lg"
+        >
+          <template #renderItem="{ item, index }">
+            <a-list-item
+              :ref="
+                (el) => {
+                  variableList[index] = el
+                }
+              "
+              class="cursor-pointer"
+              @click.prevent.stop="appendText(item)"
+            >
+              <a-list-item-meta>
+                <template #title>
+                  <div class="flex">
+                    <a-col :span="6">
+                      <span class="prose-sm text-gray-600">{{ item.text }}</span>
+                    </a-col>
+                  </div>
+                </template>
+
+                <template #avatar>
+                  <component :is="item.icon" class="text-lg" />
+                </template>
+              </a-list-item-meta>
+            </a-list-item>
+          </template>
+        </a-list>
+      </template>
     </div>
   </div>
 </template>
+
+<style lang="scss" scoped>
+:deep(.ant-list-item) {
+  @apply !pt-1.75 pb-0.75 !px-3;
+}
+</style>

From 471ce06b9aa969075182a6803dcc4fbf82c2d5ef Mon Sep 17 00:00:00 2001
From: Muhammed Mustafa <mustafa@nocodb.com>
Date: Fri, 22 Dec 2023 16:03:40 +0000
Subject: [PATCH 02/17] fix: Minor fix

---
 .../nc-gui/components/smartsheet/column/FormulaOptions.vue  | 6 ++++--
 1 file changed, 4 insertions(+), 2 deletions(-)

diff --git a/packages/nc-gui/components/smartsheet/column/FormulaOptions.vue b/packages/nc-gui/components/smartsheet/column/FormulaOptions.vue
index 203a37a57b..67ccf40c8a 100644
--- a/packages/nc-gui/components/smartsheet/column/FormulaOptions.vue
+++ b/packages/nc-gui/components/smartsheet/column/FormulaOptions.vue
@@ -95,9 +95,11 @@ const formulaRef = ref()
 
 const sugListRef = ref()
 
+const variableListRef = ref<(typeof AntListItem)[]>([])
+
 const sugOptionsRef = ref<(typeof AntListItem)[]>([])
 
-const variableListRef = ref<(typeof AntListItem)[]>([])
+const varOptionsRef = ref<(typeof AntListItem)[]>([])
 
 const wordToComplete = ref<string | undefined>('')
 
@@ -369,7 +371,7 @@ onMounted(() => {
             <a-list-item
               :ref="
                 (el) => {
-                  variableList[index] = el
+                  varOptionsRef[index] = el
                 }
               "
               class="cursor-pointer"

From 2cf7403c05be14f9275275bdc9b29190f42158a9 Mon Sep 17 00:00:00 2001
From: Muhammed Mustafa <mustafa@nocodb.com>
Date: Fri, 22 Dec 2023 16:03:41 +0000
Subject: [PATCH 03/17] fix: Added back icon

---
 .../smartsheet/column/FormulaOptions.vue      | 25 +++++++++----------
 1 file changed, 12 insertions(+), 13 deletions(-)

diff --git a/packages/nc-gui/components/smartsheet/column/FormulaOptions.vue b/packages/nc-gui/components/smartsheet/column/FormulaOptions.vue
index 67ccf40c8a..572b4097f3 100644
--- a/packages/nc-gui/components/smartsheet/column/FormulaOptions.vue
+++ b/packages/nc-gui/components/smartsheet/column/FormulaOptions.vue
@@ -346,10 +346,13 @@ onMounted(() => {
             >
               <a-list-item-meta>
                 <template #title>
-                  <div class="flex">
-                    <a-col :span="6">
-                      <span class="prose-sm text-gray-600">{{ item.text }}</span>
-                    </a-col>
+                  <div class="flex items-center gap-x-1">
+                    <component :is="iconMap.function" v-if="item.type === 'function'" class="text-lg" />
+
+                    <component :is="iconMap.calculator" v-if="item.type === 'op'" class="text-lg" />
+
+                    <component :is="item.icon" v-if="item.type === 'column'" class="text-lg" />
+                    <span class="prose-sm text-gray-600">{{ item.text }}</span>
                   </div>
                 </template>
               </a-list-item-meta>
@@ -379,15 +382,11 @@ onMounted(() => {
             >
               <a-list-item-meta>
                 <template #title>
-                  <div class="flex">
-                    <a-col :span="6">
-                      <span class="prose-sm text-gray-600">{{ item.text }}</span>
-                    </a-col>
-                  </div>
-                </template>
+                  <div class="flex items-center gap-x-1">
+                    <component :is="item.icon" class="text-lg" />
 
-                <template #avatar>
-                  <component :is="item.icon" class="text-lg" />
+                    <span class="prose-sm text-gray-600">{{ item.text }}</span>
+                  </div>
                 </template>
               </a-list-item-meta>
             </a-list-item>
@@ -400,6 +399,6 @@ onMounted(() => {
 
 <style lang="scss" scoped>
 :deep(.ant-list-item) {
-  @apply !pt-1.75 pb-0.75 !px-3;
+  @apply !pt-1.75 pb-0.75 !px-2;
 }
 </style>

From 2f6da8b0d91057fa2842b07eccefe9ab42da0f64 Mon Sep 17 00:00:00 2001
From: Muhammed Mustafa <mustafa@nocodb.com>
Date: Fri, 22 Dec 2023 16:03:41 +0000
Subject: [PATCH 04/17] fix: Added back keyboard to formula options

---
 .../smartsheet/column/FormulaOptions.vue      | 22 ++++++++++++-------
 1 file changed, 14 insertions(+), 8 deletions(-)

diff --git a/packages/nc-gui/components/smartsheet/column/FormulaOptions.vue b/packages/nc-gui/components/smartsheet/column/FormulaOptions.vue
index 572b4097f3..d3c8557365 100644
--- a/packages/nc-gui/components/smartsheet/column/FormulaOptions.vue
+++ b/packages/nc-gui/components/smartsheet/column/FormulaOptions.vue
@@ -99,8 +99,6 @@ const variableListRef = ref<(typeof AntListItem)[]>([])
 
 const sugOptionsRef = ref<(typeof AntListItem)[]>([])
 
-const varOptionsRef = ref<(typeof AntListItem)[]>([])
-
 const wordToComplete = ref<string | undefined>('')
 
 const selected = ref(0)
@@ -222,6 +220,7 @@ function selectText() {
 }
 
 function suggestionListUp() {
+  console.log('suggestionListUp', suggestion.value)
   if (suggestion.value) {
     selected.value = --selected.value > -1 ? selected.value : suggestion.value.length - 1
     scrollToSelectedOption()
@@ -238,10 +237,11 @@ function suggestionListDown() {
 function scrollToSelectedOption() {
   nextTick(() => {
     if (sugOptionsRef.value[selected.value]) {
+      console.log('scrollToSelectedOption', selected.value, sugOptionsRef.value[selected.value].$el, sugListRef.value)
       try {
-        sugListRef.value.$el.scrollTo({
-          top: sugOptionsRef.value[selected.value].$el.offsetTop,
-          behavior: 'smooth',
+        sugOptionsRef.value[selected.value].$el.scrollIntoView({
+          block: 'nearest',
+          inline: 'start',
         })
       } catch (e) {}
     }
@@ -340,7 +340,10 @@ onMounted(() => {
                   sugOptionsRef[index] = el
                 }
               "
-              class="cursor-pointer"
+              class="cursor-pointer !overflow-hidden"
+              :class="{
+                'bg-gray-100': selected === index,
+              }"
               @click.prevent.stop="appendText(item)"
               @mouseenter="suggestionPreviewed = item"
             >
@@ -368,15 +371,18 @@ onMounted(() => {
           ref="variableListRef"
           :data-source="variableList"
           :locale="{ emptyText: $t('msg.formula.noSuggestedFormulaFound') }"
-          class="border-1 border-t-0 rounded-b-lg"
+          class="border-1 border-t-0 rounded-b-lg !overflow-hidden"
         >
           <template #renderItem="{ item, index }">
             <a-list-item
               :ref="
                 (el) => {
-                  varOptionsRef[index] = el
+                  sugOptionsRef[index + suggestedFormulas.length] = el
                 }
               "
+              :class="{
+                'bg-gray-100': selected === index + suggestedFormulas.length,
+              }"
               class="cursor-pointer"
               @click.prevent.stop="appendText(item)"
             >

From f7e2c04b5b977375d0e7a6c3a7115734552bc5af Mon Sep 17 00:00:00 2001
From: Muhammed Mustafa <mustafa@nocodb.com>
Date: Fri, 22 Dec 2023 16:03:41 +0000
Subject: [PATCH 05/17] fix: Improved selected formula and hover formula logic
 and improved formula preview

---
 .../smartsheet/column/FormulaOptions.vue      | 28 ++++++++++++-------
 1 file changed, 18 insertions(+), 10 deletions(-)

diff --git a/packages/nc-gui/components/smartsheet/column/FormulaOptions.vue b/packages/nc-gui/components/smartsheet/column/FormulaOptions.vue
index d3c8557365..b80e41756e 100644
--- a/packages/nc-gui/components/smartsheet/column/FormulaOptions.vue
+++ b/packages/nc-gui/components/smartsheet/column/FormulaOptions.vue
@@ -220,9 +220,9 @@ function selectText() {
 }
 
 function suggestionListUp() {
-  console.log('suggestionListUp', suggestion.value)
   if (suggestion.value) {
     selected.value = --selected.value > -1 ? selected.value : suggestion.value.length - 1
+    suggestionPreviewed.value = suggestionsList.value[selected.value]
     scrollToSelectedOption()
   }
 }
@@ -230,6 +230,8 @@ function suggestionListUp() {
 function suggestionListDown() {
   if (suggestion.value) {
     selected.value = ++selected.value % suggestion.value.length
+    suggestionPreviewed.value = suggestionsList.value[selected.value]
+
     scrollToSelectedOption()
   }
 }
@@ -272,18 +274,23 @@ onMounted(() => {
   <div class="formula-wrapper relative">
     <div
       v-if="suggestionPreviewed && suggestionPreviewed.type === 'function'"
-      class="absolute -left-91 w-84 top-0 bg-white z-10 p-3 border-1 shadow-md rounded-xl"
+      class="absolute -left-91 w-84 top-0 bg-white z-10 px-3 pt-3 border-1 shadow-md rounded-xl"
     >
       <div class="flex flex-row w-full justify-between pb-1 border-b-1">
-        <div class="font-semibold text-base">{{ suggestionPreviewed.text }}</div>
+        <div class="flex items-center gap-x-1 font-semibold text-base">
+          <component :is="iconMap.function" class="text-lg" />
+          {{ suggestionPreviewed.text }}
+        </div>
         <NcButton type="text" size="small" @click="suggestionPreviewed = undefined">
           <GeneralIcon icon="close" />
         </NcButton>
       </div>
-      <div class="text-gray-500 uppercase text-xs mt-3 mb-1">Syntax</div>
+      <div class="flex mt-3">Lorem ipsum dolor sit amet consectetur adipisicing elit. Quisquam, voluptatum.</div>
+
+      <div class="text-gray-500 uppercase text-xs mt-3 mb-2">Syntax</div>
       <div class="bg-gray-800 text-white rounded-md py-1 px-2">{{ suggestionPreviewed.syntax }}</div>
-      <div class="text-gray-500 uppercase text-xs mt-3 mb-1">Examples</div>
-      <div v-for="example of suggestionPreviewed.examples" :key="example" class="bg-gray-100 rounded-md py-1 px-2 mb-1">
+      <div class="text-gray-500 uppercase text-xs mt-3 mb-2">Examples</div>
+      <div v-for="example of suggestionPreviewed.examples" :key="example" class="bg-gray-100 rounded-md py-1 px-2 mb-3">
         {{ example }}
       </div>
     </div>
@@ -332,6 +339,7 @@ onMounted(() => {
           :data-source="suggestedFormulas"
           :locale="{ emptyText: $t('msg.formula.noSuggestedFormulaFound') }"
           class="border-1 border-t-0 rounded-b-lg !mb-4"
+          @mouseleave="suggestionPreviewed = suggestionsList[selected]"
         >
           <template #renderItem="{ item, index }">
             <a-list-item
@@ -340,9 +348,9 @@ onMounted(() => {
                   sugOptionsRef[index] = el
                 }
               "
-              class="cursor-pointer !overflow-hidden"
+              class="cursor-pointer !overflow-hidden hover:bg-gray-50"
               :class="{
-                'bg-gray-100': selected === index,
+                '!bg-gray-100': selected === index,
               }"
               @click.prevent.stop="appendText(item)"
               @mouseenter="suggestionPreviewed = item"
@@ -381,9 +389,9 @@ onMounted(() => {
                 }
               "
               :class="{
-                'bg-gray-100': selected === index + suggestedFormulas.length,
+                '!bg-gray-100': selected === index + suggestedFormulas.length,
               }"
-              class="cursor-pointer"
+              class="cursor-pointer hover:bg-gray-50"
               @click.prevent.stop="appendText(item)"
             >
               <a-list-item-meta>

From 107fcb79e5cab2ac77fd7189d216c30170845541 Mon Sep 17 00:00:00 2001
From: Muhammed Mustafa <mustafa@nocodb.com>
Date: Fri, 22 Dec 2023 16:03:41 +0000
Subject: [PATCH 06/17] fix: Made formula modal smaller

---
 packages/nc-gui/components/smartsheet/column/EditOrAdd.vue | 3 +--
 1 file changed, 1 insertion(+), 2 deletions(-)

diff --git a/packages/nc-gui/components/smartsheet/column/EditOrAdd.vue b/packages/nc-gui/components/smartsheet/column/EditOrAdd.vue
index e8d74b1959..dc586639b0 100644
--- a/packages/nc-gui/components/smartsheet/column/EditOrAdd.vue
+++ b/packages/nc-gui/components/smartsheet/column/EditOrAdd.vue
@@ -224,8 +224,7 @@ if (props.fromTableExplorer) {
       'bg-white': !props.fromTableExplorer,
       'w-[400px]': !props.embedMode,
       '!w-146': isTextArea(formState) && formState.meta?.richMode,
-      '!w-[600px]': formState.uidt === UITypes.Formula && !props.embedMode,
-      'overflow-visible': formState.uidt === UITypes.Formula,
+      '!w-116 overflow-visible': formState.uidt === UITypes.Formula && !props.embedMode,
       '!w-[500px]': formState.uidt === UITypes.Attachment && !props.embedMode && !appInfo.ee,
       'shadow-lg border-1 border-gray-200 shadow-gray-300 rounded-xl p-6': !embedMode,
     }"

From 2b046b8ceda7b132a06d08f1f15b378ede67e990 Mon Sep 17 00:00:00 2001
From: Muhammed Mustafa <mustafa@nocodb.com>
Date: Fri, 22 Dec 2023 16:03:41 +0000
Subject: [PATCH 07/17] fix: Fixed issue with formula selection through enter
 and removed hint for {} variable

---
 .../smartsheet/column/FormulaOptions.vue      | 37 ++++++++-----------
 1 file changed, 16 insertions(+), 21 deletions(-)

diff --git a/packages/nc-gui/components/smartsheet/column/FormulaOptions.vue b/packages/nc-gui/components/smartsheet/column/FormulaOptions.vue
index b80e41756e..07863e7567 100644
--- a/packages/nc-gui/components/smartsheet/column/FormulaOptions.vue
+++ b/packages/nc-gui/components/smartsheet/column/FormulaOptions.vue
@@ -145,6 +145,13 @@ const suggestionsList = computed(() => {
 // set default suggestion list
 const suggestion: Ref<Record<string, any>[]> = ref(suggestionsList.value)
 
+const suggestedFormulas = computed(() => {
+  return suggestion.value.filter((s) => s && s.type !== 'column')
+})
+const variableList = computed(() => {
+  return suggestion.value.filter((s) => s && s.type === 'column')
+})
+
 const acTree = computed(() => {
   const ref = new NcAutocompleteTree()
   for (const sug of suggestionsList.value) {
@@ -214,9 +221,15 @@ function handleInput() {
 }
 
 function selectText() {
-  if (suggestion.value && selected.value > -1 && selected.value < suggestion.value.length) {
-    appendText(suggestion.value[selected.value])
+  if (suggestion.value && selected.value > -1 && selected.value < suggestionsList.value.length) {
+    if (selected.value < suggestedFormulas.value.length) {
+      appendText(suggestedFormulas.value[selected.value])
+    } else {
+      appendText(variableList.value[selected.value + suggestedFormulas.value.length])
+    }
   }
+
+  selected.value = 0
 }
 
 function suggestionListUp() {
@@ -305,7 +318,7 @@ onMounted(() => {
       <a-textarea
         ref="formulaRef"
         v-model:value="vModel.formula_raw"
-        class="mb-2 nc-formula-input"
+        class="!mb-4 nc-formula-input !rounded-md"
         @keydown.down.prevent="suggestionListDown"
         @keydown.up.prevent="suggestionListUp"
         @keydown.enter.prevent="selectText"
@@ -313,24 +326,6 @@ onMounted(() => {
       />
     </a-form-item>
 
-    <div class="text-gray-600 mt-2 mb-4 prose-sm">
-      {{
-        // As using {} in translation will be treated as placeholder, and this translation contain {} as part of th text
-        $t('msg.formula.hintStart', {
-          placeholder1: '{}',
-          placeholder2: '{column_name}',
-        })
-      }}
-      <a
-        class="prose-sm"
-        href="https://docs.nocodb.com/setup-and-usages/formulas#available-formula-features"
-        target="_blank"
-        rel="noopener"
-      >
-        {{ $t('msg.formula.hintEnd') }}
-      </a>
-    </div>
-
     <div ref="sugListRef" class="h-[250px] overflow-auto nc-scrollbar-md">
       <template v-if="suggestedFormulas.length > 0">
         <div class="rounded-t-lg border-1 bg-gray-50 px-3 py-1 uppercase text-gray-600 text-xs">Formulas</div>

From c938d6446092f05374baf43c9751195fa2fddc64 Mon Sep 17 00:00:00 2001
From: Muhammed Mustafa <mustafa@nocodb.com>
Date: Fri, 22 Dec 2023 16:03:41 +0000
Subject: [PATCH 08/17] fix: To close column type dropdown on escape and close
 modal only when the type popup is close

---
 .../components/smartsheet/column/EditOrAdd.vue  | 17 +++++++++++++++++
 1 file changed, 17 insertions(+)

diff --git a/packages/nc-gui/components/smartsheet/column/EditOrAdd.vue b/packages/nc-gui/components/smartsheet/column/EditOrAdd.vue
index dc586639b0..8e03ad9746 100644
--- a/packages/nc-gui/components/smartsheet/column/EditOrAdd.vue
+++ b/packages/nc-gui/components/smartsheet/column/EditOrAdd.vue
@@ -81,6 +81,10 @@ const columnToValidate = [UITypes.Email, UITypes.URL, UITypes.PhoneNumber]
 
 const onlyNameUpdateOnEditColumns = [UITypes.LinkToAnotherRecord, UITypes.Lookup, UITypes.Rollup, UITypes.Links]
 
+// To close column type dropdown on escape and
+// close modal only when the type popup is close
+const isColumnTypeOpen = ref(false)
+
 const geoDataToggleCondition = (t: { name: UITypes }) => {
   if (!appInfo.value.ee) return true
 
@@ -199,6 +203,8 @@ onMounted(() => {
 })
 
 const handleEscape = (event: KeyboardEvent): void => {
+  if (isColumnTypeOpen.value) return
+
   if (event.key === 'Escape') emit('cancel')
 }
 
@@ -206,6 +212,16 @@ const isFieldsTab = computed(() => {
   return openedViewsTab.value === 'field'
 })
 
+const onDropdownChange = (value: boolean) => {
+  if (value) {
+    isColumnTypeOpen.value = value
+  } else {
+    setTimeout(() => {
+      isColumnTypeOpen.value = value
+    }, 300)
+  }
+}
+
 if (props.fromTableExplorer) {
   watch(
     formState,
@@ -275,6 +291,7 @@ if (props.fromTableExplorer) {
               class="nc-column-type-input !rounded"
               :disabled="isKanban || readOnly"
               dropdown-class-name="nc-dropdown-column-type border-1 !rounded-md border-gray-200"
+              @dropdown-visible-change="onDropdownChange"
               @change="onUidtOrIdTypeChange"
               @dblclick="showDeprecated = !showDeprecated"
             >

From 70103f6c8fb92797c1365543dcd057698709f2b8 Mon Sep 17 00:00:00 2001
From: Muhammed Mustafa <mustafa@nocodb.com>
Date: Fri, 22 Dec 2023 16:03:41 +0000
Subject: [PATCH 09/17] fix: Minor fix

---
 .../nc-gui/components/smartsheet/column/FormulaOptions.vue | 7 +++++--
 1 file changed, 5 insertions(+), 2 deletions(-)

diff --git a/packages/nc-gui/components/smartsheet/column/FormulaOptions.vue b/packages/nc-gui/components/smartsheet/column/FormulaOptions.vue
index 07863e7567..50c62b0818 100644
--- a/packages/nc-gui/components/smartsheet/column/FormulaOptions.vue
+++ b/packages/nc-gui/components/smartsheet/column/FormulaOptions.vue
@@ -307,7 +307,7 @@ onMounted(() => {
         {{ example }}
       </div>
     </div>
-    <a-form-item v-bind="validateInfos.formula_raw" :label="$t('datatype.Formula')">
+    <a-form-item v-bind="validateInfos.formula_raw" class="!pb-1" :label="$t('datatype.Formula')">
       <!-- <GeneralIcon
         v-if="isEeUI"
         icon="magic"
@@ -318,7 +318,7 @@ onMounted(() => {
       <a-textarea
         ref="formulaRef"
         v-model:value="vModel.formula_raw"
-        class="!mb-4 nc-formula-input !rounded-md"
+        class="nc-formula-input !rounded-md !mb-1"
         @keydown.down.prevent="suggestionListDown"
         @keydown.up.prevent="suggestionListUp"
         @keydown.enter.prevent="selectText"
@@ -402,6 +402,9 @@ onMounted(() => {
           </template>
         </a-list>
       </template>
+      <div v-if="suggestion.length === 0">
+        <span class="text-gray-500">Empty</span>
+      </div>
     </div>
   </div>
 </template>

From c89fb95c95dc3ebdb403076cfe376d2d216abaac Mon Sep 17 00:00:00 2001
From: Muhammed Mustafa <mustafa@nocodb.com>
Date: Fri, 22 Dec 2023 16:03:41 +0000
Subject: [PATCH 10/17] fix: Removed validation on formula name if typed
 manually

---
 .../smartsheet/column/FormulaOptions.vue         | 16 ++++++++--------
 1 file changed, 8 insertions(+), 8 deletions(-)

diff --git a/packages/nc-gui/components/smartsheet/column/FormulaOptions.vue b/packages/nc-gui/components/smartsheet/column/FormulaOptions.vue
index 50c62b0818..23625fd060 100644
--- a/packages/nc-gui/components/smartsheet/column/FormulaOptions.vue
+++ b/packages/nc-gui/components/smartsheet/column/FormulaOptions.vue
@@ -145,13 +145,6 @@ const suggestionsList = computed(() => {
 // set default suggestion list
 const suggestion: Ref<Record<string, any>[]> = ref(suggestionsList.value)
 
-const suggestedFormulas = computed(() => {
-  return suggestion.value.filter((s) => s && s.type !== 'column')
-})
-const variableList = computed(() => {
-  return suggestion.value.filter((s) => s && s.type === 'column')
-})
-
 const acTree = computed(() => {
   const ref = new NcAutocompleteTree()
   for (const sug of suggestionsList.value) {
@@ -160,6 +153,14 @@ const acTree = computed(() => {
   return ref
 })
 
+const suggestedFormulas = computed(() => {
+  return suggestion.value.filter((s) => s && s.type !== 'column')
+})
+
+const variableList = computed(() => {
+  return suggestion.value.filter((s) => s && s.type === 'column')
+})
+
 function isCurlyBracketBalanced() {
   // count number of opening curly brackets and closing curly brackets
   const cntCurlyBrackets = (formulaRef.value.$el.value.match(/\{|}/g) || []).reduce(
@@ -252,7 +253,6 @@ function suggestionListDown() {
 function scrollToSelectedOption() {
   nextTick(() => {
     if (sugOptionsRef.value[selected.value]) {
-      console.log('scrollToSelectedOption', selected.value, sugOptionsRef.value[selected.value].$el, sugListRef.value)
       try {
         sugOptionsRef.value[selected.value].$el.scrollIntoView({
           block: 'nearest',

From 5dd497dfb2c21640c2b60f158589e70ca1c23dfb Mon Sep 17 00:00:00 2001
From: Muhammed Mustafa <mustafa@nocodb.com>
Date: Fri, 22 Dec 2023 16:03:41 +0000
Subject: [PATCH 11/17] fix: Minor UI fix

---
 packages/nc-gui/components/smartsheet/column/FormulaOptions.vue | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/nc-gui/components/smartsheet/column/FormulaOptions.vue b/packages/nc-gui/components/smartsheet/column/FormulaOptions.vue
index 23625fd060..ffa676e589 100644
--- a/packages/nc-gui/components/smartsheet/column/FormulaOptions.vue
+++ b/packages/nc-gui/components/smartsheet/column/FormulaOptions.vue
@@ -318,7 +318,7 @@ onMounted(() => {
       <a-textarea
         ref="formulaRef"
         v-model:value="vModel.formula_raw"
-        class="nc-formula-input !rounded-md !mb-1"
+        class="nc-formula-input !rounded-md !my-1"
         @keydown.down.prevent="suggestionListDown"
         @keydown.up.prevent="suggestionListUp"
         @keydown.enter.prevent="selectText"

From c9a00f76d112d9598cdf4e25157dff24fbd3a39a Mon Sep 17 00:00:00 2001
From: Muhammed Mustafa <mustafa@nocodb.com>
Date: Fri, 22 Dec 2023 16:03:41 +0000
Subject: [PATCH 12/17] fix: Added docs btn in formula option

---
 .../components/smartsheet/column/FormulaOptions.vue       | 8 ++++++++
 1 file changed, 8 insertions(+)

diff --git a/packages/nc-gui/components/smartsheet/column/FormulaOptions.vue b/packages/nc-gui/components/smartsheet/column/FormulaOptions.vue
index ffa676e589..e24806de71 100644
--- a/packages/nc-gui/components/smartsheet/column/FormulaOptions.vue
+++ b/packages/nc-gui/components/smartsheet/column/FormulaOptions.vue
@@ -306,6 +306,14 @@ onMounted(() => {
       <div v-for="example of suggestionPreviewed.examples" :key="example" class="bg-gray-100 rounded-md py-1 px-2 mb-3">
         {{ example }}
       </div>
+      <div class="flex flex-row mt-1 mb-3 justify-end">
+        <a target="_blank" rel="noopener noreferrer" href="https://docs.nocodb.com/fields/field-types/formula/date-functions">
+          <NcButton type="text" class="!text-gray-500 !hover:text-gray-800"
+            >View in Docs
+            <GeneralIcon icon="openInNew" class="ml-1" />
+          </NcButton>
+        </a>
+      </div>
     </div>
     <a-form-item v-bind="validateInfos.formula_raw" class="!pb-1" :label="$t('datatype.Formula')">
       <!-- <GeneralIcon

From fd4833f84ab325c9cc4bc8f0dd87a091b1cb802a Mon Sep 17 00:00:00 2001
From: Muhammed Mustafa <mustafa@nocodb.com>
Date: Fri, 22 Dec 2023 16:03:42 +0000
Subject: [PATCH 13/17] fix: Added formula docs URL and added scroll to formula
 preview

---
 .../smartsheet/column/FormulaOptions.vue      | 41 +++++++++++--------
 1 file changed, 23 insertions(+), 18 deletions(-)

diff --git a/packages/nc-gui/components/smartsheet/column/FormulaOptions.vue b/packages/nc-gui/components/smartsheet/column/FormulaOptions.vue
index e24806de71..21645cd2ea 100644
--- a/packages/nc-gui/components/smartsheet/column/FormulaOptions.vue
+++ b/packages/nc-gui/components/smartsheet/column/FormulaOptions.vue
@@ -120,6 +120,7 @@ const suggestionsList = computed(() => {
         description: formulas[fn].description,
         syntax: formulas[fn].syntax,
         examples: formulas[fn].examples,
+        docsUrl: formulas[fn].docsUrl,
       })),
     ...supportedColumns.value
       .filter((c) => {
@@ -287,27 +288,31 @@ onMounted(() => {
   <div class="formula-wrapper relative">
     <div
       v-if="suggestionPreviewed && suggestionPreviewed.type === 'function'"
-      class="absolute -left-91 w-84 top-0 bg-white z-10 px-3 pt-3 border-1 shadow-md rounded-xl"
+      class="absolute -left-91 w-84 top-0 bg-white z-10 pl-3 pt-3 border-1 shadow-md rounded-xl"
     >
-      <div class="flex flex-row w-full justify-between pb-1 border-b-1">
-        <div class="flex items-center gap-x-1 font-semibold text-base">
-          <component :is="iconMap.function" class="text-lg" />
-          {{ suggestionPreviewed.text }}
+      <div class="pr-3">
+        <div class="flex flex-row w-full justify-between pb-1 border-b-1">
+          <div class="flex items-center gap-x-1 font-semibold text-base">
+            <component :is="iconMap.function" class="text-lg" />
+            {{ suggestionPreviewed.text }}
+          </div>
+          <NcButton type="text" size="small" @click="suggestionPreviewed = undefined">
+            <GeneralIcon icon="close" />
+          </NcButton>
         </div>
-        <NcButton type="text" size="small" @click="suggestionPreviewed = undefined">
-          <GeneralIcon icon="close" />
-        </NcButton>
       </div>
-      <div class="flex mt-3">Lorem ipsum dolor sit amet consectetur adipisicing elit. Quisquam, voluptatum.</div>
-
-      <div class="text-gray-500 uppercase text-xs mt-3 mb-2">Syntax</div>
-      <div class="bg-gray-800 text-white rounded-md py-1 px-2">{{ suggestionPreviewed.syntax }}</div>
-      <div class="text-gray-500 uppercase text-xs mt-3 mb-2">Examples</div>
-      <div v-for="example of suggestionPreviewed.examples" :key="example" class="bg-gray-100 rounded-md py-1 px-2 mb-3">
-        {{ example }}
+      <div class="flex flex-col max-h-120 nc-scrollbar-md pr-2">
+        <div class="flex mt-3">{{ suggestionPreviewed.description }}</div>
+
+        <div class="text-gray-500 uppercase text-xs mt-3 mb-2">Syntax</div>
+        <div class="bg-gray-800 text-white rounded-md py-1 px-2">{{ suggestionPreviewed.syntax }}</div>
+        <div class="text-gray-500 uppercase text-xs mt-3 mb-2">Examples</div>
+        <div v-for="example of suggestionPreviewed.examples" :key="example" class="bg-gray-100 rounded-md py-1 px-2 mb-3">
+          {{ example }}
+        </div>
       </div>
-      <div class="flex flex-row mt-1 mb-3 justify-end">
-        <a target="_blank" rel="noopener noreferrer" href="https://docs.nocodb.com/fields/field-types/formula/date-functions">
+      <div class="flex flex-row mt-1 mb-3 justify-end pr-3">
+        <a target="_blank" rel="noopener noreferrer" :href="suggestionPreviewed.docsUrl">
           <NcButton type="text" class="!text-gray-500 !hover:text-gray-800"
             >View in Docs
             <GeneralIcon icon="openInNew" class="ml-1" />
@@ -342,7 +347,6 @@ onMounted(() => {
           :data-source="suggestedFormulas"
           :locale="{ emptyText: $t('msg.formula.noSuggestedFormulaFound') }"
           class="border-1 border-t-0 rounded-b-lg !mb-4"
-          @mouseleave="suggestionPreviewed = suggestionsList[selected]"
         >
           <template #renderItem="{ item, index }">
             <a-list-item
@@ -354,6 +358,7 @@ onMounted(() => {
               class="cursor-pointer !overflow-hidden hover:bg-gray-50"
               :class="{
                 '!bg-gray-100': selected === index,
+                '!bg-gray-50': suggestionPreviewed?.syntax === item.syntax && selected !== index,
               }"
               @click.prevent.stop="appendText(item)"
               @mouseenter="suggestionPreviewed = item"

From d6cc42bd90d2df52b513cf67184737661a8b8536 Mon Sep 17 00:00:00 2001
From: Muhammed Mustafa <mustafa@nocodb.com>
Date: Fri, 22 Dec 2023 16:03:42 +0000
Subject: [PATCH 14/17] fix: UI improvements

---
 .../components/smartsheet/column/FormulaOptions.vue | 13 +++++++++++--
 1 file changed, 11 insertions(+), 2 deletions(-)

diff --git a/packages/nc-gui/components/smartsheet/column/FormulaOptions.vue b/packages/nc-gui/components/smartsheet/column/FormulaOptions.vue
index 21645cd2ea..b7a6c9e5a5 100644
--- a/packages/nc-gui/components/smartsheet/column/FormulaOptions.vue
+++ b/packages/nc-gui/components/smartsheet/column/FormulaOptions.vue
@@ -305,9 +305,18 @@ onMounted(() => {
         <div class="flex mt-3">{{ suggestionPreviewed.description }}</div>
 
         <div class="text-gray-500 uppercase text-xs mt-3 mb-2">Syntax</div>
-        <div class="bg-gray-800 text-white rounded-md py-1 px-2">{{ suggestionPreviewed.syntax }}</div>
+        <div class="bg-white rounded-md py-1 px-2 border-1">{{ suggestionPreviewed.syntax }}</div>
         <div class="text-gray-500 uppercase text-xs mt-3 mb-2">Examples</div>
-        <div v-for="example of suggestionPreviewed.examples" :key="example" class="bg-gray-100 rounded-md py-1 px-2 mb-3">
+        <div
+          v-for="(example, index) of suggestionPreviewed.examples"
+          :key="example"
+          class="bg-gray-100 py-1 px-2"
+          :class="{
+            'border-t-1 border-gray-200': index !== 0 || suggestionPreviewed.examples.length === 1,
+            'rounded-b-md': index === suggestionPreviewed.examples.length - 1 && suggestionPreviewed.examples.length !== 1,
+            'rounded-t-md': index === 0 && suggestionPreviewed.examples.length !== 1,
+          }"
+        >
           {{ example }}
         </div>
       </div>

From 0d77ba0f9a075bd3e2ca5a49f3659fdd11903bfe Mon Sep 17 00:00:00 2001
From: Muhammed Mustafa <mustafa@nocodb.com>
Date: Fri, 22 Dec 2023 16:03:42 +0000
Subject: [PATCH 15/17] fix: Formula preview is maintained on input changes

---
 .../nc-gui/components/smartsheet/column/FormulaOptions.vue | 7 ++-----
 1 file changed, 2 insertions(+), 5 deletions(-)

diff --git a/packages/nc-gui/components/smartsheet/column/FormulaOptions.vue b/packages/nc-gui/components/smartsheet/column/FormulaOptions.vue
index b7a6c9e5a5..b8446e4ea3 100644
--- a/packages/nc-gui/components/smartsheet/column/FormulaOptions.vue
+++ b/packages/nc-gui/components/smartsheet/column/FormulaOptions.vue
@@ -212,8 +212,6 @@ function handleInput() {
 
   if (suggestion.value.length > 0 && suggestion.value[0].type !== 'column') {
     suggestionPreviewed.value = suggestion.value[0]
-  } else {
-    suggestionPreviewed.value = undefined
   }
 
   if (!isCurlyBracketBalanced()) {
@@ -237,7 +235,7 @@ function selectText() {
 function suggestionListUp() {
   if (suggestion.value) {
     selected.value = --selected.value > -1 ? selected.value : suggestion.value.length - 1
-    suggestionPreviewed.value = suggestionsList.value[selected.value]
+    suggestionPreviewed.value = suggestedFormulas.value[selected.value]
     scrollToSelectedOption()
   }
 }
@@ -245,7 +243,7 @@ function suggestionListUp() {
 function suggestionListDown() {
   if (suggestion.value) {
     selected.value = ++selected.value % suggestion.value.length
-    suggestionPreviewed.value = suggestionsList.value[selected.value]
+    suggestionPreviewed.value = suggestedFormulas.value[selected.value]
 
     scrollToSelectedOption()
   }
@@ -367,7 +365,6 @@ onMounted(() => {
               class="cursor-pointer !overflow-hidden hover:bg-gray-50"
               :class="{
                 '!bg-gray-100': selected === index,
-                '!bg-gray-50': suggestionPreviewed?.syntax === item.syntax && selected !== index,
               }"
               @click.prevent.stop="appendText(item)"
               @mouseenter="suggestionPreviewed = item"

From 037161b7e86040e20d7cfd911df5e1e06a1a8843 Mon Sep 17 00:00:00 2001
From: Muhammed Mustafa <mustafa@nocodb.com>
Date: Fri, 22 Dec 2023 16:03:42 +0000
Subject: [PATCH 16/17] fix: Fixed rebase issues

---
 .../smartsheet/column/FormulaOptions.vue      |   3 +-
 packages/nocodb-sdk/src/lib/formulaHelpers.ts | 135 ++++++++++++++++++
 2 files changed, 137 insertions(+), 1 deletion(-)

diff --git a/packages/nc-gui/components/smartsheet/column/FormulaOptions.vue b/packages/nc-gui/components/smartsheet/column/FormulaOptions.vue
index b8446e4ea3..54412182bd 100644
--- a/packages/nc-gui/components/smartsheet/column/FormulaOptions.vue
+++ b/packages/nc-gui/components/smartsheet/column/FormulaOptions.vue
@@ -310,9 +310,10 @@ onMounted(() => {
           :key="example"
           class="bg-gray-100 py-1 px-2"
           :class="{
-            'border-t-1 border-gray-200': index !== 0 || suggestionPreviewed.examples.length === 1,
+            'border-t-1 border-gray-200': index !== 0,
             'rounded-b-md': index === suggestionPreviewed.examples.length - 1 && suggestionPreviewed.examples.length !== 1,
             'rounded-t-md': index === 0 && suggestionPreviewed.examples.length !== 1,
+            'rounded-md': suggestionPreviewed.examples.length === 1,
           }"
         >
           {{ example }}
diff --git a/packages/nocodb-sdk/src/lib/formulaHelpers.ts b/packages/nocodb-sdk/src/lib/formulaHelpers.ts
index 01b7e369ef..7dd4680cd9 100644
--- a/packages/nocodb-sdk/src/lib/formulaHelpers.ts
+++ b/packages/nocodb-sdk/src/lib/formulaHelpers.ts
@@ -275,6 +275,7 @@ interface FormulaMeta {
   syntax?: string;
   examples?: string[];
   returnType?: ((args: any[]) => FormulaDataTypes) | FormulaDataTypes;
+  docsUrl?: string;
 }
 
 export const formulas: Record<string, FormulaMeta> = {
@@ -293,6 +294,8 @@ export const formulas: Record<string, FormulaMeta> = {
       'AVG({column1}, {column2}, {column3})',
     ],
     returnType: FormulaDataTypes.NUMERIC,
+    docsUrl:
+      'https://docs.nocodb.com/fields/field-types/formula/numeric-functions#avg',
   },
   ADD: {
     validation: {
@@ -309,8 +312,12 @@ export const formulas: Record<string, FormulaMeta> = {
       'ADD({column1}, {column2}, {column3})',
     ],
     returnType: FormulaDataTypes.NUMERIC,
+    docsUrl:
+      'https://docs.nocodb.com/fields/field-types/formula/numeric-functions#add',
   },
   DATEADD: {
+    docsUrl:
+      'https://docs.nocodb.com/fields/field-types/formula/date-functions#dateadd',
     validation: {
       args: {
         rqd: 3,
@@ -407,6 +414,9 @@ export const formulas: Record<string, FormulaMeta> = {
     returnType: FormulaDataTypes.STRING,
   },
   DATETIME_DIFF: {
+    docsUrl:
+      'https://docs.nocodb.com/fields/field-types/formula/date-functions#datetime_diff',
+
     validation: {
       args: {
         min: 2,
@@ -486,6 +496,9 @@ export const formulas: Record<string, FormulaMeta> = {
     returnType: FormulaDataTypes.NUMERIC,
   },
   AND: {
+    docsUrl:
+      'https://docs.nocodb.com/fields/field-types/formula/conditional-expressions#and',
+
     validation: {
       args: {
         min: 1,
@@ -497,6 +510,9 @@ export const formulas: Record<string, FormulaMeta> = {
     returnType: FormulaDataTypes.COND_EXP,
   },
   OR: {
+    docsUrl:
+      'https://docs.nocodb.com/fields/field-types/formula/conditional-expressions#or',
+
     validation: {
       args: {
         min: 1,
@@ -508,6 +524,9 @@ export const formulas: Record<string, FormulaMeta> = {
     returnType: FormulaDataTypes.COND_EXP,
   },
   CONCAT: {
+    docsUrl:
+      'https://docs.nocodb.com/fields/field-types/formula/string-functions#concat',
+
     validation: {
       args: {
         min: 1,
@@ -522,6 +541,9 @@ export const formulas: Record<string, FormulaMeta> = {
     returnType: FormulaDataTypes.STRING,
   },
   TRIM: {
+    docsUrl:
+      'https://docs.nocodb.com/fields/field-types/formula/string-functions#trim',
+
     validation: {
       args: {
         rqd: 1,
@@ -537,6 +559,9 @@ export const formulas: Record<string, FormulaMeta> = {
     returnType: FormulaDataTypes.STRING,
   },
   UPPER: {
+    docsUrl:
+      'https://docs.nocodb.com/fields/field-types/formula/string-functions#upper',
+
     validation: {
       args: {
         rqd: 1,
@@ -549,6 +574,9 @@ export const formulas: Record<string, FormulaMeta> = {
     returnType: FormulaDataTypes.STRING,
   },
   LOWER: {
+    docsUrl:
+      'https://docs.nocodb.com/fields/field-types/formula/string-functions#lower',
+
     validation: {
       args: {
         rqd: 1,
@@ -561,6 +589,9 @@ export const formulas: Record<string, FormulaMeta> = {
     returnType: FormulaDataTypes.STRING,
   },
   LEN: {
+    docsUrl:
+      'https://docs.nocodb.com/fields/field-types/formula/string-functions#len',
+
     validation: {
       args: {
         rqd: 1,
@@ -573,6 +604,9 @@ export const formulas: Record<string, FormulaMeta> = {
     returnType: FormulaDataTypes.NUMERIC,
   },
   MIN: {
+    docsUrl:
+      'https://docs.nocodb.com/fields/field-types/formula/numeric-functions#min',
+
     validation: {
       args: {
         min: 1,
@@ -585,6 +619,9 @@ export const formulas: Record<string, FormulaMeta> = {
     returnType: FormulaDataTypes.NUMERIC,
   },
   MAX: {
+    docsUrl:
+      'https://docs.nocodb.com/fields/field-types/formula/numeric-functions#max',
+
     validation: {
       args: {
         min: 1,
@@ -597,6 +634,9 @@ export const formulas: Record<string, FormulaMeta> = {
     returnType: FormulaDataTypes.NUMERIC,
   },
   CEILING: {
+    docsUrl:
+      'https://docs.nocodb.com/fields/field-types/formula/numeric-functions#ceiling',
+
     validation: {
       args: {
         rqd: 1,
@@ -609,6 +649,9 @@ export const formulas: Record<string, FormulaMeta> = {
     returnType: FormulaDataTypes.NUMERIC,
   },
   FLOOR: {
+    docsUrl:
+      'https://docs.nocodb.com/fields/field-types/formula/numeric-functions#floor',
+
     validation: {
       args: {
         rqd: 1,
@@ -622,6 +665,9 @@ export const formulas: Record<string, FormulaMeta> = {
     returnType: FormulaDataTypes.NUMERIC,
   },
   ROUND: {
+    docsUrl:
+      'https://docs.nocodb.com/fields/field-types/formula/numeric-functions#round',
+
     validation: {
       args: {
         min: 1,
@@ -640,6 +686,9 @@ export const formulas: Record<string, FormulaMeta> = {
     returnType: FormulaDataTypes.NUMERIC,
   },
   MOD: {
+    docsUrl:
+      'https://docs.nocodb.com/fields/field-types/formula/numeric-functions#mod',
+
     validation: {
       args: {
         rqd: 2,
@@ -652,6 +701,9 @@ export const formulas: Record<string, FormulaMeta> = {
     returnType: FormulaDataTypes.NUMERIC,
   },
   REPEAT: {
+    docsUrl:
+      'https://docs.nocodb.com/fields/field-types/formula/string-functions#repeat',
+
     validation: {
       args: {
         rqd: 2,
@@ -666,6 +718,9 @@ export const formulas: Record<string, FormulaMeta> = {
     returnType: FormulaDataTypes.STRING,
   },
   LOG: {
+    docsUrl:
+      'https://docs.nocodb.com/fields/field-types/formula/numeric-functions#log',
+
     validation: {
       args: {
         type: FormulaDataTypes.NUMERIC,
@@ -678,6 +733,9 @@ export const formulas: Record<string, FormulaMeta> = {
     returnType: FormulaDataTypes.NUMERIC,
   },
   EXP: {
+    docsUrl:
+      'https://docs.nocodb.com/fields/field-types/formula/numeric-functions#exp',
+
     validation: {
       args: {
         type: FormulaDataTypes.NUMERIC,
@@ -689,6 +747,9 @@ export const formulas: Record<string, FormulaMeta> = {
     returnType: FormulaDataTypes.NUMERIC,
   },
   POWER: {
+    docsUrl:
+      'https://docs.nocodb.com/fields/field-types/formula/numeric-functions#power',
+
     validation: {
       args: {
         rqd: 2,
@@ -701,6 +762,9 @@ export const formulas: Record<string, FormulaMeta> = {
     returnType: FormulaDataTypes.NUMERIC,
   },
   SQRT: {
+    docsUrl:
+      'https://docs.nocodb.com/fields/field-types/formula/numeric-functions#sqrt',
+
     validation: {
       args: {
         rqd: 1,
@@ -713,6 +777,9 @@ export const formulas: Record<string, FormulaMeta> = {
     returnType: FormulaDataTypes.NUMERIC,
   },
   ABS: {
+    docsUrl:
+      'https://docs.nocodb.com/fields/field-types/formula/numeric-functions#abs',
+
     validation: {
       args: {
         rqd: 1,
@@ -725,6 +792,9 @@ export const formulas: Record<string, FormulaMeta> = {
     returnType: FormulaDataTypes.NUMERIC,
   },
   NOW: {
+    docsUrl:
+      'https://docs.nocodb.com/fields/field-types/formula/date-functions#now',
+
     validation: {
       args: {
         rqd: 0,
@@ -737,6 +807,9 @@ export const formulas: Record<string, FormulaMeta> = {
     returnType: FormulaDataTypes.DATE,
   },
   REPLACE: {
+    docsUrl:
+      'https://docs.nocodb.com/fields/field-types/formula/string-functions#replace',
+
     validation: {
       args: {
         rqd: 3,
@@ -753,6 +826,9 @@ export const formulas: Record<string, FormulaMeta> = {
     returnType: FormulaDataTypes.STRING,
   },
   SEARCH: {
+    docsUrl:
+      'https://docs.nocodb.com/fields/field-types/formula/string-functions#search',
+
     validation: {
       args: {
         rqd: 2,
@@ -768,6 +844,9 @@ export const formulas: Record<string, FormulaMeta> = {
     returnType: FormulaDataTypes.NUMERIC,
   },
   INT: {
+    docsUrl:
+      'https://docs.nocodb.com/fields/field-types/formula/numeric-functions#int',
+
     validation: {
       args: {
         rqd: 1,
@@ -780,6 +859,9 @@ export const formulas: Record<string, FormulaMeta> = {
     returnType: FormulaDataTypes.NUMERIC,
   },
   RIGHT: {
+    docsUrl:
+      'https://docs.nocodb.com/fields/field-types/formula/string-functions#right',
+
     validation: {
       args: {
         rqd: 2,
@@ -792,6 +874,9 @@ export const formulas: Record<string, FormulaMeta> = {
     returnType: FormulaDataTypes.STRING,
   },
   LEFT: {
+    docsUrl:
+      'https://docs.nocodb.com/fields/field-types/formula/string-functions#left',
+
     validation: {
       args: {
         rqd: 2,
@@ -804,6 +889,9 @@ export const formulas: Record<string, FormulaMeta> = {
     returnType: FormulaDataTypes.STRING,
   },
   SUBSTR: {
+    docsUrl:
+      'https://docs.nocodb.com/fields/field-types/formula/string-functions#substr',
+
     validation: {
       args: {
         min: 2,
@@ -822,6 +910,9 @@ export const formulas: Record<string, FormulaMeta> = {
     returnType: FormulaDataTypes.STRING,
   },
   MID: {
+    docsUrl:
+      'https://docs.nocodb.com/fields/field-types/formula/string-functions#mid',
+
     validation: {
       args: {
         rqd: 3,
@@ -834,6 +925,9 @@ export const formulas: Record<string, FormulaMeta> = {
     returnType: FormulaDataTypes.STRING,
   },
   IF: {
+    docsUrl:
+      'https://docs.nocodb.com/fields/field-types/formula/conditional-expressions#if',
+
     validation: {
       args: {
         min: 2,
@@ -871,6 +965,9 @@ export const formulas: Record<string, FormulaMeta> = {
     },
   },
   SWITCH: {
+    docsUrl:
+      'https://docs.nocodb.com/fields/field-types/formula/conditional-expressions#switch',
+
     validation: {
       args: {
         min: 3,
@@ -913,6 +1010,9 @@ export const formulas: Record<string, FormulaMeta> = {
     },
   },
   URL: {
+    docsUrl:
+      'https://docs.nocodb.com/fields/field-types/formula/string-functions#url',
+
     validation: {
       args: {
         rqd: 1,
@@ -925,6 +1025,9 @@ export const formulas: Record<string, FormulaMeta> = {
     returnType: FormulaDataTypes.STRING,
   },
   WEEKDAY: {
+    docsUrl:
+      'https://docs.nocodb.com/fields/field-types/formula/date-functions#weekday',
+
     validation: {
       args: {
         min: 1,
@@ -986,6 +1089,9 @@ export const formulas: Record<string, FormulaMeta> = {
     syntax: 'TRUE()',
     examples: ['TRUE()'],
     returnType: FormulaDataTypes.NUMERIC,
+    // TODO: Add docs url
+    docsUrl:
+      'https://docs.nocodb.com/fields/field-types/formula/logical-functions#true',
   },
 
   FALSE: {
@@ -998,6 +1104,9 @@ export const formulas: Record<string, FormulaMeta> = {
     syntax: 'FALSE()',
     examples: ['FALSE()'],
     returnType: FormulaDataTypes.NUMERIC,
+    // TODO: Add docs url
+    docsUrl:
+      'https://docs.nocodb.com/fields/field-types/formula/logical-functions#false',
   },
 
   REGEX_MATCH: {
@@ -1025,6 +1134,8 @@ export const formulas: Record<string, FormulaMeta> = {
     syntax: 'REGEX_EXTRACT(string, regex)',
     examples: ['REGEX_EXTRACT({title}, "abc.*")'],
     returnType: FormulaDataTypes.STRING,
+    docsUrl:
+      'https://docs.nocodb.com/fields/field-types/formula/string-functions#regex_extract',
   },
   REGEX_REPLACE: {
     validation: {
@@ -1038,6 +1149,8 @@ export const formulas: Record<string, FormulaMeta> = {
     syntax: 'REGEX_MATCH(string, regex, replacement)',
     examples: ['REGEX_EXTRACT({title}, "abc.*", "abcd")'],
     returnType: FormulaDataTypes.STRING,
+    docsUrl:
+      'https://docs.nocodb.com/fields/field-types/formula/string-functions#regex_replace',
   },
   BLANK: {
     validation: {
@@ -1049,6 +1162,9 @@ export const formulas: Record<string, FormulaMeta> = {
     syntax: 'BLANK()',
     examples: ['BLANK()'],
     returnType: FormulaDataTypes.NULL,
+    // TODO: Add docs url
+    docsUrl:
+      'https://docs.nocodb.com/fields/field-types/formula/logical-functions#blank',
   },
   XOR: {
     validation: {
@@ -1062,6 +1178,9 @@ export const formulas: Record<string, FormulaMeta> = {
     syntax: 'XOR(expression, [exp2, ...])',
     examples: ['XOR(TRUE(), FALSE(), TRUE())'],
     returnType: FormulaDataTypes.BOOLEAN,
+    // TODO: Add docs url
+    docsUrl:
+      'https://docs.nocodb.com/fields/field-types/formula/logical-functions#xor',
   },
   EVEN: {
     validation: {
@@ -1075,6 +1194,8 @@ export const formulas: Record<string, FormulaMeta> = {
     syntax: 'EVEN(value)',
     examples: ['EVEN({column})'],
     returnType: FormulaDataTypes.NUMERIC,
+    docsUrl:
+      'https://docs.nocodb.com/fields/field-types/formula/numeric-functions#even',
   },
   ODD: {
     validation: {
@@ -1088,6 +1209,8 @@ export const formulas: Record<string, FormulaMeta> = {
     syntax: 'ODD(value)',
     examples: ['ODD({column})'],
     returnType: FormulaDataTypes.NUMERIC,
+    docsUrl:
+      'https://docs.nocodb.com/fields/field-types/formula/numeric-functions#odd',
   },
   RECORD_ID: {
     validation: {
@@ -1114,6 +1237,8 @@ export const formulas: Record<string, FormulaMeta> = {
     syntax: 'COUNTA(value1, [value2, ...])',
     examples: ['COUNTA({field1}, {field2})'],
     returnType: FormulaDataTypes.NUMERIC,
+    docsUrl:
+      'https://docs.nocodb.com/fields/field-types/formula/numeric-functions#counta',
   },
   COUNT: {
     validation: {
@@ -1125,6 +1250,8 @@ export const formulas: Record<string, FormulaMeta> = {
     syntax: 'COUNT(value1, [value2, ...])',
     examples: ['COUNT({field1}, {field2})'],
     returnType: FormulaDataTypes.NUMERIC,
+    docsUrl:
+      'https://docs.nocodb.com/fields/field-types/formula/numeric-functions#count',
   },
   COUNTALL: {
     validation: {
@@ -1136,6 +1263,8 @@ export const formulas: Record<string, FormulaMeta> = {
     syntax: 'COUNTALL(value1, [value2, ...])',
     examples: ['COUNTALL({field1}, {field2})'],
     returnType: FormulaDataTypes.NUMERIC,
+    docsUrl:
+      'https://docs.nocodb.com/fields/field-types/formula/numeric-functions#countall',
   },
   ROUNDDOWN: {
     validation: {
@@ -1150,6 +1279,8 @@ export const formulas: Record<string, FormulaMeta> = {
     syntax: 'ROUNDDOWN(value, [precision])',
     examples: ['ROUNDDOWN({field1})', 'ROUNDDOWN({field1}, 2)'],
     returnType: FormulaDataTypes.NUMERIC,
+    docsUrl:
+      'https://docs.nocodb.com/fields/field-types/formula/numeric-functions#rounddown',
   },
   ROUNDUP: {
     validation: {
@@ -1164,6 +1295,8 @@ export const formulas: Record<string, FormulaMeta> = {
     syntax: 'ROUNDUP(value, [precision])',
     examples: ['ROUNDUP({field1})', 'ROUNDUP({field1}, 2)'],
     returnType: FormulaDataTypes.NUMERIC,
+    docsUrl:
+      'https://docs.nocodb.com/fields/field-types/formula/numeric-functions#roundup',
   },
   VALUE: {
     validation: {
@@ -1176,6 +1309,8 @@ export const formulas: Record<string, FormulaMeta> = {
     syntax: 'VALUE(value)',
     examples: ['VALUE({field})', 'VALUE("abc10000%")', 'VALUE("$10000")'],
     returnType: FormulaDataTypes.NUMERIC,
+    docsUrl:
+      'https://docs.nocodb.com/fields/field-types/formula/numeric-functions#value',
   },
   // Disabling these functions for now; these act as alias for CreatedAt & UpdatedAt fields;
   // Issue: Error noticed if CreatedAt & UpdatedAt fields are removed from the table after creating these formulas

From 9092188cf349eded2b0793bff66438c3f8d1ea75 Mon Sep 17 00:00:00 2001
From: Raju Udava <86527202+dstala@users.noreply.github.com>
Date: Fri, 22 Dec 2023 16:03:42 +0000
Subject: [PATCH 17/17] fix: text corrections

---
 .../smartsheet/column/FormulaOptions.vue      |   2 +-
 packages/nocodb-sdk/src/lib/formulaHelpers.ts | 119 ++++++++++--------
 2 files changed, 66 insertions(+), 55 deletions(-)

diff --git a/packages/nc-gui/components/smartsheet/column/FormulaOptions.vue b/packages/nc-gui/components/smartsheet/column/FormulaOptions.vue
index 54412182bd..bb9191caf2 100644
--- a/packages/nc-gui/components/smartsheet/column/FormulaOptions.vue
+++ b/packages/nc-gui/components/smartsheet/column/FormulaOptions.vue
@@ -321,7 +321,7 @@ onMounted(() => {
       </div>
       <div class="flex flex-row mt-1 mb-3 justify-end pr-3">
         <a target="_blank" rel="noopener noreferrer" :href="suggestionPreviewed.docsUrl">
-          <NcButton type="text" class="!text-gray-500 !hover:text-gray-800"
+          <NcButton type="text" class="!text-gray-400 !hover:text-gray-800 !text-xs"
             >View in Docs
             <GeneralIcon icon="openInNew" class="ml-1" />
           </NcButton>
diff --git a/packages/nocodb-sdk/src/lib/formulaHelpers.ts b/packages/nocodb-sdk/src/lib/formulaHelpers.ts
index 7dd4680cd9..cda0be6a04 100644
--- a/packages/nocodb-sdk/src/lib/formulaHelpers.ts
+++ b/packages/nocodb-sdk/src/lib/formulaHelpers.ts
@@ -358,9 +358,9 @@ export const formulas: Record<string, FormulaMeta> = {
         }
       },
     },
-    description: 'Adds a "count" units to Datetime.',
+    description: 'Adds "count" units to Datetime.',
     syntax:
-      'DATEADD(date | datetime, value, ["day" | "week" | "month" | "year"])',
+      'DATEADD(date | datetime, count, ["day" | "week" | "month" | "year"])',
     examples: [
       'DATEADD({column1}, 2, "day")',
       'DATEADD({column1}, -2, "day")',
@@ -379,7 +379,8 @@ export const formulas: Record<string, FormulaMeta> = {
         rqd: 1,
       },
     },
-    description: 'Formats a datetime into a string (YYYY-MM-DD)',
+    syntax: 'DATESTR(date | datetime)',
+    description: 'Formats input field into a string in "YYYY-MM-DD" format',
     examples: ['DATESTR({column1})'],
     returnType: FormulaDataTypes.STRING,
   },
@@ -389,7 +390,8 @@ export const formulas: Record<string, FormulaMeta> = {
         rqd: 1,
       },
     },
-    description: 'Extract day from a date(1-31)',
+    syntax: 'DAY(date | datetime)',
+    description: 'Extract day from a date field (1-31)',
     examples: ['DAY({column1})'],
     returnType: FormulaDataTypes.STRING,
   },
@@ -399,7 +401,8 @@ export const formulas: Record<string, FormulaMeta> = {
         rqd: 1,
       },
     },
-    description: 'Extract month from a date(1-12)',
+    syntax: 'MONTH(date | datetime)',
+    description: 'Extract month from a date field (1-12)',
     examples: ['MONTH({column1})'],
     returnType: FormulaDataTypes.STRING,
   },
@@ -409,7 +412,8 @@ export const formulas: Record<string, FormulaMeta> = {
         rqd: 1,
       },
     },
-    description: 'Extract hour from a datetime(0-23)',
+    syntax: 'DAY(time | datetime)',
+    description: 'Extract hour from a time field (0-23)',
     examples: ['HOUR({column1})'],
     returnType: FormulaDataTypes.STRING,
   },
@@ -479,7 +483,7 @@ export const formulas: Record<string, FormulaMeta> = {
       },
     },
     description:
-      'Calculate the difference of two given date / datetime in specified units.',
+      'Calculate the difference of two given date / datetime fields in specified units.',
     syntax:
       'DATETIME_DIFF(date | datetime, date | datetime, ["milliseconds" | "ms" | "seconds" | "s" | "minutes" | "m" | "hours" | "h" | "days" | "d" | "weeks" | "w" | "months" | "M" | "quarters" | "Q" | "years" | "y"])',
     examples: [
@@ -504,7 +508,7 @@ export const formulas: Record<string, FormulaMeta> = {
         min: 1,
       },
     },
-    description: 'TRUE if all expr evaluate to TRUE',
+    description: 'Result is TRUE if all conditions are met',
     syntax: 'AND(expr1, [expr2, ...])',
     examples: ['AND(5 > 2, 5 < 10) => 1', 'AND({column1} > 2, {column2} < 10)'],
     returnType: FormulaDataTypes.COND_EXP,
@@ -518,7 +522,7 @@ export const formulas: Record<string, FormulaMeta> = {
         min: 1,
       },
     },
-    description: 'TRUE if at least one expr evaluates to TRUE',
+    description: 'Result is TRUE if at least one condition is met',
     syntax: 'OR(expr1, [expr2, ...])',
     examples: ['OR(5 > 2, 5 < 10) => 1', 'OR({column1} > 2, {column2} < 10)'],
     returnType: FormulaDataTypes.COND_EXP,
@@ -532,7 +536,7 @@ export const formulas: Record<string, FormulaMeta> = {
         min: 1,
       },
     },
-    description: 'Concatenated string of input parameters',
+    description: 'Concatenate input parameters into a single string',
     syntax: 'CONCAT(str1, [str2, ...])',
     examples: [
       'CONCAT("AA", "BB", "CC") => "AABBCC"',
@@ -568,7 +572,7 @@ export const formulas: Record<string, FormulaMeta> = {
         type: FormulaDataTypes.STRING,
       },
     },
-    description: 'Upper case converted string of input parameter',
+    description: 'Converts the input parameter to an upper-case string.',
     syntax: 'UPPER(str)',
     examples: ['UPPER("nocodb") => "NOCODB"', 'UPPER({column1})'],
     returnType: FormulaDataTypes.STRING,
@@ -583,7 +587,7 @@ export const formulas: Record<string, FormulaMeta> = {
         type: FormulaDataTypes.STRING,
       },
     },
-    description: 'Lower case converted string of input parameter',
+    description: 'Converts the input parameter to an lower-case string.',
     syntax: 'LOWER(str)',
     examples: ['LOWER("NOCODB") => "nocodb"', 'LOWER({column1})'],
     returnType: FormulaDataTypes.STRING,
@@ -598,7 +602,7 @@ export const formulas: Record<string, FormulaMeta> = {
         type: FormulaDataTypes.STRING,
       },
     },
-    description: 'Input parameter character length',
+    description: 'Calculate the character length of the input parameter.',
     syntax: 'LEN(value)',
     examples: ['LEN("NocoDB") => 6', 'LEN({column1})'],
     returnType: FormulaDataTypes.NUMERIC,
@@ -613,7 +617,7 @@ export const formulas: Record<string, FormulaMeta> = {
         type: FormulaDataTypes.NUMERIC,
       },
     },
-    description: 'Minimum value amongst input parameters',
+    description: 'Find the minimum value among the input parameters.',
     syntax: 'MIN(value1, [value2, ...])',
     examples: ['MIN(1000, 2000) => 1000', 'MIN({column1}, {column2})'],
     returnType: FormulaDataTypes.NUMERIC,
@@ -628,7 +632,7 @@ export const formulas: Record<string, FormulaMeta> = {
         type: FormulaDataTypes.NUMERIC,
       },
     },
-    description: 'Maximum value amongst input parameters',
+    description: 'Find the maximum value among the input parameters.',
     syntax: 'MAX(value1, [value2, ...])',
     examples: ['MAX(1000, 2000) => 2000', 'MAX({column1}, {column2})'],
     returnType: FormulaDataTypes.NUMERIC,
@@ -643,7 +647,8 @@ export const formulas: Record<string, FormulaMeta> = {
         type: FormulaDataTypes.NUMERIC,
       },
     },
-    description: 'Rounded next largest integer value of input parameter',
+    description:
+      'Rounds the input parameter to the next largest integer value.',
     syntax: 'CEILING(value)',
     examples: ['CEILING(1.01) => 2', 'CEILING({column1})'],
     returnType: FormulaDataTypes.NUMERIC,
@@ -658,8 +663,7 @@ export const formulas: Record<string, FormulaMeta> = {
         type: FormulaDataTypes.NUMERIC,
       },
     },
-    description:
-      'Rounded largest integer less than or equal to input parameter',
+    description: 'Round down the input parameter to the nearest integer.',
     syntax: 'FLOOR(value)',
     examples: ['FLOOR(3.1415) => 3', 'FLOOR({column1})'],
     returnType: FormulaDataTypes.NUMERIC,
@@ -676,7 +680,7 @@ export const formulas: Record<string, FormulaMeta> = {
       },
     },
     description:
-      'Rounded number to a specified number of decimal places or the nearest integer if not specified',
+      'Rounds the number to a specified decimal places or the nearest integer if precision is not specified',
     syntax: 'ROUND(value, precision), ROUND(value)',
     examples: [
       'ROUND(3.1415) => 3',
@@ -695,7 +699,8 @@ export const formulas: Record<string, FormulaMeta> = {
         type: FormulaDataTypes.NUMERIC,
       },
     },
-    description: 'Remainder after integer division of input parameters',
+    description:
+      'Calculate the remainder resulting from integer division of input parameters.',
     syntax: 'MOD(value1, value2)',
     examples: ['MOD(1024, 1000) => 24', 'MOD({column}, 2)'],
     returnType: FormulaDataTypes.NUMERIC,
@@ -712,7 +717,7 @@ export const formulas: Record<string, FormulaMeta> = {
       },
     },
     description:
-      'Specified copies of the input parameter string concatenated together',
+      'Concatenate the specified number of copies of the input parameter string.',
     syntax: 'REPEAT(str, count)',
     examples: ['REPEAT("A", 5) => "AAAAA"', 'REPEAT({column}, 5)'],
     returnType: FormulaDataTypes.STRING,
@@ -727,7 +732,7 @@ export const formulas: Record<string, FormulaMeta> = {
       },
     },
     description:
-      'Logarithm of input parameter to the base (default = e) specified',
+      'Compute the logarithm of the input parameter to the specified base (default = e).',
     syntax: 'LOG([base], value)',
     examples: ['LOG(2, 1024) => 10', 'LOG(2, {column1})'],
     returnType: FormulaDataTypes.NUMERIC,
@@ -741,7 +746,8 @@ export const formulas: Record<string, FormulaMeta> = {
         type: FormulaDataTypes.NUMERIC,
       },
     },
-    description: 'Exponential value of input parameter (e ^ power)',
+    description:
+      'Compute the exponential value of the input parameter (e raised to the power specified)',
     syntax: 'EXP(power)',
     examples: ['EXP(1) => 2.718281828459045', 'EXP({column1})'],
     returnType: FormulaDataTypes.NUMERIC,
@@ -756,7 +762,7 @@ export const formulas: Record<string, FormulaMeta> = {
         type: FormulaDataTypes.NUMERIC,
       },
     },
-    description: 'base to the exponent power, as in base ^ exponent',
+    description: 'Compute base raised to the exponent power.',
     syntax: 'POWER(base, exponent)',
     examples: ['POWER(2, 10) => 1024', 'POWER({column1}, 10)'],
     returnType: FormulaDataTypes.NUMERIC,
@@ -771,7 +777,7 @@ export const formulas: Record<string, FormulaMeta> = {
         type: FormulaDataTypes.NUMERIC,
       },
     },
-    description: 'Square root of the input parameter',
+    description: 'Calculate the square root of the input parameter.',
     syntax: 'SQRT(value)',
     examples: ['SQRT(100) => 10', 'SQRT({column1})'],
     returnType: FormulaDataTypes.NUMERIC,
@@ -786,7 +792,7 @@ export const formulas: Record<string, FormulaMeta> = {
         type: FormulaDataTypes.NUMERIC,
       },
     },
-    description: 'Absolute value of the input parameter',
+    description: 'Obtain the absolute value of the input parameter.',
     syntax: 'ABS(value)',
     examples: ['ABS({column1})'],
     returnType: FormulaDataTypes.NUMERIC,
@@ -801,7 +807,7 @@ export const formulas: Record<string, FormulaMeta> = {
         type: FormulaDataTypes.DATE,
       },
     },
-    description: 'Returns the current time and day',
+    description: 'Retrieve the current time and day.',
     syntax: 'NOW()',
     examples: ['NOW() => 2022-05-19 17:20:43'],
     returnType: FormulaDataTypes.DATE,
@@ -817,8 +823,8 @@ export const formulas: Record<string, FormulaMeta> = {
       },
     },
     description:
-      'String, after replacing all occurrences of srchStr with rplcStr',
-    syntax: 'REPLACE(str, srchStr, rplcStr)',
+      'Replace all occurrences of "searchStr" with "replaceStr" in the given string.',
+    syntax: 'REPLACE(str, searchStr, replaceStr)',
     examples: [
       'REPLACE("AABBCC", "AA", "BB") => "BBBBCC"',
       'REPLACE({column1}, {column2}, {column3})',
@@ -835,8 +841,9 @@ export const formulas: Record<string, FormulaMeta> = {
         type: FormulaDataTypes.STRING,
       },
     },
-    description: 'Index of srchStr specified if found, 0 otherwise',
-    syntax: 'SEARCH(str, srchStr)',
+    description:
+      'Retrieve the index of the specified "searchStr" if found; otherwise, returns 0.',
+    syntax: 'SEARCH(str, searchStr)',
     examples: [
       'SEARCH("HELLO WORLD", "WORLD") => 7',
       'SEARCH({column1}, "abc")',
@@ -853,7 +860,7 @@ export const formulas: Record<string, FormulaMeta> = {
         type: FormulaDataTypes.NUMERIC,
       },
     },
-    description: 'Integer value of input parameter',
+    description: 'Obtain the integer value of the input parameter',
     syntax: 'INT(value)',
     examples: ['INT(3.1415) => 3', 'INT({column1})'],
     returnType: FormulaDataTypes.NUMERIC,
@@ -868,7 +875,7 @@ export const formulas: Record<string, FormulaMeta> = {
         type: FormulaDataTypes.STRING,
       },
     },
-    description: 'n characters from the end of input parameter',
+    description: 'Retrieve the last n characters from the input string.',
     syntax: 'RIGHT(str, n)',
     examples: ['RIGHT("HELLO WORLD", 5) => WORLD', 'RIGHT({column1}, 3)'],
     returnType: FormulaDataTypes.STRING,
@@ -883,7 +890,7 @@ export const formulas: Record<string, FormulaMeta> = {
         type: FormulaDataTypes.STRING,
       },
     },
-    description: 'n characters from the beginning of input parameter',
+    description: 'Retrieve the first n characters from the input string.',
     syntax: 'LEFT(str, n)',
     examples: ['LEFT({column1}, 2)', 'LEFT("ABCD", 2) => "AB"'],
     returnType: FormulaDataTypes.STRING,
@@ -900,7 +907,7 @@ export const formulas: Record<string, FormulaMeta> = {
       },
     },
     description:
-      'Substring of length n of input string from the postition specified',
+      'Extracts a substring of length "n" from the input string, starting from the specified position.',
     syntax: '	SUBTR(str, position, [n])',
     examples: [
       'SUBSTR("HELLO WORLD", 7) => WORLD',
@@ -919,7 +926,7 @@ export const formulas: Record<string, FormulaMeta> = {
         type: FormulaDataTypes.STRING,
       },
     },
-    description: 'Alias for SUBSTR',
+    description: 'Extracts a substring; an alias for SUBSTR.',
     syntax: 'MID(str, position, [count])',
     examples: ['MID("NocoDB", 3, 2) => "co"', 'MID({column1}, 3, 2)'],
     returnType: FormulaDataTypes.STRING,
@@ -934,8 +941,9 @@ export const formulas: Record<string, FormulaMeta> = {
         max: 3,
       },
     },
-    description: 'SuccessCase if expr evaluates to TRUE, elseCase otherwise',
-    syntax: 'IF(expr, successCase, elseCase)',
+    description:
+      'Evaluate successCase if the expression is TRUE, else the failureCase.',
+    syntax: 'IF(expr, successCase, failureCase)',
     examples: [
       'IF(5 > 1, "YES", "NO") => "YES"',
       'IF({column} > 1, "YES", "NO")',
@@ -976,7 +984,8 @@ export const formulas: Record<string, FormulaMeta> = {
         // Todo: Add validation for switch
       },
     },
-    description: 'Switch case value based on expr output',
+    description:
+      'Evaluate case value based on expression output; if no match is found, evaluate default case.',
     syntax: 'SWITCH(expr, [pattern, value, ..., default])',
     examples: [
       'SWITCH(1, 1, "One", 2, "Two", "N/A") => "One""',
@@ -1019,7 +1028,8 @@ export const formulas: Record<string, FormulaMeta> = {
         type: FormulaDataTypes.STRING,
       },
     },
-    description: 'Convert to a hyperlink if it is a valid URL',
+    description:
+      'Verify and convert to a hyperlink if the input is a valid URL.',
     syntax: 'URL(str)',
     examples: ['URL("https://github.com/nocodb/nocodb")', 'URL({column1})'],
     returnType: FormulaDataTypes.STRING,
@@ -1073,7 +1083,7 @@ export const formulas: Record<string, FormulaMeta> = {
       },
     },
     description:
-      'Returns the day of the week as an integer between 0 and 6 inclusive starting from Monday by default',
+      'Retrieve the day of the week as an integer (0-6), starting from Monday by default.',
     syntax: 'WEEKDAY(date, [startDayOfWeek])',
     examples: ['WEEKDAY("2021-06-09")', 'WEEKDAY(NOW(), "sunday")'],
     returnType: FormulaDataTypes.NUMERIC,
@@ -1117,7 +1127,7 @@ export const formulas: Record<string, FormulaMeta> = {
       },
     },
     description:
-      'Returns 1 if the input text matches a regular expression or 0 if it does not.',
+      'Verifies whether the input text matches a regular expression, returning 1 for a match and 0 otherwise.',
     syntax: 'REGEX_MATCH(string, regex)',
     examples: ['REGEX_MATCH({title}, "abc.*")'],
     returnType: FormulaDataTypes.NUMERIC,
@@ -1130,7 +1140,8 @@ export const formulas: Record<string, FormulaMeta> = {
         type: FormulaDataTypes.STRING,
       },
     },
-    description: 'Returns the first match of a regular expression in a string.',
+    description:
+      'Retrieve the first match of a regular expression in a string.',
     syntax: 'REGEX_EXTRACT(string, regex)',
     examples: ['REGEX_EXTRACT({title}, "abc.*")'],
     returnType: FormulaDataTypes.STRING,
@@ -1145,7 +1156,7 @@ export const formulas: Record<string, FormulaMeta> = {
       },
     },
     description:
-      'Replaces all matches of a regular expression in a string with a replacement string',
+      'Replace all occurrences of a regular expression in a string with a specified replacement string.',
     syntax: 'REGEX_MATCH(string, regex, replacement)',
     examples: ['REGEX_EXTRACT({title}, "abc.*", "abcd")'],
     returnType: FormulaDataTypes.STRING,
@@ -1158,7 +1169,7 @@ export const formulas: Record<string, FormulaMeta> = {
         rqd: 0,
       },
     },
-    description: 'Returns a blank value(null)',
+    description: 'Yields a null value.',
     syntax: 'BLANK()',
     examples: ['BLANK()'],
     returnType: FormulaDataTypes.NULL,
@@ -1174,7 +1185,7 @@ export const formulas: Record<string, FormulaMeta> = {
       // todo: validation for boolean
     },
     description:
-      'Returns true if an odd number of arguments are true, and false otherwise.',
+      'Verifies whether an odd number of arguments are true, returning true if so, and false otherwise.',
     syntax: 'XOR(expression, [exp2, ...])',
     examples: ['XOR(TRUE(), FALSE(), TRUE())'],
     returnType: FormulaDataTypes.BOOLEAN,
@@ -1190,7 +1201,7 @@ export const formulas: Record<string, FormulaMeta> = {
       },
     },
     description:
-      'Returns the nearest even integer that is greater than or equal to the specified value',
+      'Rounds up the specified value to the nearest even integer that is greater than or equal to the specified value',
     syntax: 'EVEN(value)',
     examples: ['EVEN({column})'],
     returnType: FormulaDataTypes.NUMERIC,
@@ -1205,7 +1216,7 @@ export const formulas: Record<string, FormulaMeta> = {
       },
     },
     description:
-      'Returns the nearest odd integer that is greater than or equal to the specified value',
+      'Rounds up the specified value to the nearest odd integer that is greater than or equal to the specified value',
     syntax: 'ODD(value)',
     examples: ['ODD({column})'],
     returnType: FormulaDataTypes.NUMERIC,
@@ -1218,7 +1229,7 @@ export const formulas: Record<string, FormulaMeta> = {
         rqd: 0,
       },
     },
-    description: 'Returns the record id of the current record',
+    description: 'Retrieve the record ID of the current record.',
     syntax: 'RECORD_ID()',
     examples: ['RECORD_ID()'],
 
@@ -1233,7 +1244,7 @@ export const formulas: Record<string, FormulaMeta> = {
         min: 1,
       },
     },
-    description: 'Counts the number of non-empty arguments',
+    description: 'Counts non-empty arguments',
     syntax: 'COUNTA(value1, [value2, ...])',
     examples: ['COUNTA({field1}, {field2})'],
     returnType: FormulaDataTypes.NUMERIC,
@@ -1246,7 +1257,7 @@ export const formulas: Record<string, FormulaMeta> = {
         min: 1,
       },
     },
-    description: 'Count the number of arguments that are numbers',
+    description: 'Counts numerical arguments',
     syntax: 'COUNT(value1, [value2, ...])',
     examples: ['COUNT({field1}, {field2})'],
     returnType: FormulaDataTypes.NUMERIC,
@@ -1275,7 +1286,7 @@ export const formulas: Record<string, FormulaMeta> = {
       },
     },
     description:
-      'Round down the value after the decimal point to the number of decimal places given by "precision"(default is 0)',
+      'Rounds down the value after the decimal point to the specified number of decimal places given by "precision" (default is 0).',
     syntax: 'ROUNDDOWN(value, [precision])',
     examples: ['ROUNDDOWN({field1})', 'ROUNDDOWN({field1}, 2)'],
     returnType: FormulaDataTypes.NUMERIC,
@@ -1291,7 +1302,7 @@ export const formulas: Record<string, FormulaMeta> = {
       },
     },
     description:
-      'Round up the value after the decimal point to the number of decimal places given by "precision"(default is 0)',
+      'Rounds up the value after the decimal point to the specified number of decimal places given by "precision" (default is 0).',
     syntax: 'ROUNDUP(value, [precision])',
     examples: ['ROUNDUP({field1})', 'ROUNDUP({field1}, 2)'],
     returnType: FormulaDataTypes.NUMERIC,
@@ -1305,7 +1316,7 @@ export const formulas: Record<string, FormulaMeta> = {
       },
     },
     description:
-      'Extract the numeric value from a string, if `%` or `-` is present, it will handle it accordingly and return the numeric value',
+      'Extracts the numeric value from a string, handling % or - appropriately, and returns the resulting numeric value.',
     syntax: 'VALUE(value)',
     examples: ['VALUE({field})', 'VALUE("abc10000%")', 'VALUE("$10000")'],
     returnType: FormulaDataTypes.NUMERIC,