diff --git a/changelog/index.html b/changelog/index.html
index 9ecde0f..bd8365b 100644
--- a/changelog/index.html
+++ b/changelog/index.html
@@ -542,6 +542,39 @@
     </label>
     <ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
       
+        <li class="md-nav__item">
+  <a href="#1570-2024-12-20" class="md-nav__link">
+    <span class="md-ellipsis">
+      1.57.0 (2024-12-20)
+    </span>
+  </a>
+  
+    <nav class="md-nav" aria-label="1.57.0 (2024-12-20)">
+      <ul class="md-nav__list">
+        
+          <li class="md-nav__item">
+  <a href="#features" class="md-nav__link">
+    <span class="md-ellipsis">
+      Features
+    </span>
+  </a>
+  
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#bug-fixes" class="md-nav__link">
+    <span class="md-ellipsis">
+      Bug Fixes
+    </span>
+  </a>
+  
+</li>
+        
+      </ul>
+    </nav>
+  
+</li>
+      
         <li class="md-nav__item">
   <a href="#1560-2024-12-19" class="md-nav__link">
     <span class="md-ellipsis">
@@ -553,7 +586,7 @@
       <ul class="md-nav__list">
         
           <li class="md-nav__item">
-  <a href="#features" class="md-nav__link">
+  <a href="#features_1" class="md-nav__link">
     <span class="md-ellipsis">
       Features
     </span>
@@ -577,7 +610,7 @@
       <ul class="md-nav__list">
         
           <li class="md-nav__item">
-  <a href="#features_1" class="md-nav__link">
+  <a href="#features_2" class="md-nav__link">
     <span class="md-ellipsis">
       Features
     </span>
@@ -586,7 +619,7 @@
 </li>
         
           <li class="md-nav__item">
-  <a href="#bug-fixes" class="md-nav__link">
+  <a href="#bug-fixes_1" class="md-nav__link">
     <span class="md-ellipsis">
       Bug Fixes
     </span>
@@ -610,7 +643,7 @@
       <ul class="md-nav__list">
         
           <li class="md-nav__item">
-  <a href="#features_2" class="md-nav__link">
+  <a href="#features_3" class="md-nav__link">
     <span class="md-ellipsis">
       Features
     </span>
@@ -634,7 +667,7 @@
       <ul class="md-nav__list">
         
           <li class="md-nav__item">
-  <a href="#features_3" class="md-nav__link">
+  <a href="#features_4" class="md-nav__link">
     <span class="md-ellipsis">
       Features
     </span>
@@ -658,7 +691,7 @@
       <ul class="md-nav__list">
         
           <li class="md-nav__item">
-  <a href="#features_4" class="md-nav__link">
+  <a href="#features_5" class="md-nav__link">
     <span class="md-ellipsis">
       Features
     </span>
@@ -682,7 +715,7 @@
       <ul class="md-nav__list">
         
           <li class="md-nav__item">
-  <a href="#features_5" class="md-nav__link">
+  <a href="#features_6" class="md-nav__link">
     <span class="md-ellipsis">
       Features
     </span>
@@ -706,7 +739,7 @@
       <ul class="md-nav__list">
         
           <li class="md-nav__item">
-  <a href="#features_6" class="md-nav__link">
+  <a href="#features_7" class="md-nav__link">
     <span class="md-ellipsis">
       Features
     </span>
@@ -715,7 +748,7 @@
 </li>
         
           <li class="md-nav__item">
-  <a href="#bug-fixes_1" class="md-nav__link">
+  <a href="#bug-fixes_2" class="md-nav__link">
     <span class="md-ellipsis">
       Bug Fixes
     </span>
@@ -739,7 +772,7 @@
       <ul class="md-nav__list">
         
           <li class="md-nav__item">
-  <a href="#features_7" class="md-nav__link">
+  <a href="#features_8" class="md-nav__link">
     <span class="md-ellipsis">
       Features
     </span>
@@ -748,7 +781,7 @@
 </li>
         
           <li class="md-nav__item">
-  <a href="#bug-fixes_2" class="md-nav__link">
+  <a href="#bug-fixes_3" class="md-nav__link">
     <span class="md-ellipsis">
       Bug Fixes
     </span>
@@ -772,7 +805,7 @@
       <ul class="md-nav__list">
         
           <li class="md-nav__item">
-  <a href="#features_8" class="md-nav__link">
+  <a href="#features_9" class="md-nav__link">
     <span class="md-ellipsis">
       Features
     </span>
@@ -781,7 +814,7 @@
 </li>
         
           <li class="md-nav__item">
-  <a href="#bug-fixes_3" class="md-nav__link">
+  <a href="#bug-fixes_4" class="md-nav__link">
     <span class="md-ellipsis">
       Bug Fixes
     </span>
@@ -805,7 +838,7 @@
       <ul class="md-nav__list">
         
           <li class="md-nav__item">
-  <a href="#features_9" class="md-nav__link">
+  <a href="#features_10" class="md-nav__link">
     <span class="md-ellipsis">
       Features
     </span>
@@ -814,7 +847,7 @@
 </li>
         
           <li class="md-nav__item">
-  <a href="#bug-fixes_4" class="md-nav__link">
+  <a href="#bug-fixes_5" class="md-nav__link">
     <span class="md-ellipsis">
       Bug Fixes
     </span>
@@ -838,7 +871,7 @@
       <ul class="md-nav__list">
         
           <li class="md-nav__item">
-  <a href="#features_10" class="md-nav__link">
+  <a href="#features_11" class="md-nav__link">
     <span class="md-ellipsis">
       Features
     </span>
@@ -847,7 +880,7 @@
 </li>
         
           <li class="md-nav__item">
-  <a href="#bug-fixes_5" class="md-nav__link">
+  <a href="#bug-fixes_6" class="md-nav__link">
     <span class="md-ellipsis">
       Bug Fixes
     </span>
@@ -871,7 +904,7 @@
       <ul class="md-nav__list">
         
           <li class="md-nav__item">
-  <a href="#bug-fixes_6" class="md-nav__link">
+  <a href="#bug-fixes_7" class="md-nav__link">
     <span class="md-ellipsis">
       Bug Fixes
     </span>
@@ -895,7 +928,7 @@
       <ul class="md-nav__list">
         
           <li class="md-nav__item">
-  <a href="#bug-fixes_7" class="md-nav__link">
+  <a href="#bug-fixes_8" class="md-nav__link">
     <span class="md-ellipsis">
       Bug Fixes
     </span>
@@ -919,7 +952,7 @@
       <ul class="md-nav__list">
         
           <li class="md-nav__item">
-  <a href="#features_11" class="md-nav__link">
+  <a href="#features_12" class="md-nav__link">
     <span class="md-ellipsis">
       Features
     </span>
@@ -943,7 +976,7 @@
       <ul class="md-nav__list">
         
           <li class="md-nav__item">
-  <a href="#bug-fixes_8" class="md-nav__link">
+  <a href="#bug-fixes_9" class="md-nav__link">
     <span class="md-ellipsis">
       Bug Fixes
     </span>
@@ -967,7 +1000,7 @@
       <ul class="md-nav__list">
         
           <li class="md-nav__item">
-  <a href="#features_12" class="md-nav__link">
+  <a href="#features_13" class="md-nav__link">
     <span class="md-ellipsis">
       Features
     </span>
@@ -976,7 +1009,7 @@
 </li>
         
           <li class="md-nav__item">
-  <a href="#bug-fixes_9" class="md-nav__link">
+  <a href="#bug-fixes_10" class="md-nav__link">
     <span class="md-ellipsis">
       Bug Fixes
     </span>
@@ -1000,7 +1033,7 @@
       <ul class="md-nav__list">
         
           <li class="md-nav__item">
-  <a href="#features_13" class="md-nav__link">
+  <a href="#features_14" class="md-nav__link">
     <span class="md-ellipsis">
       Features
     </span>
@@ -1024,7 +1057,7 @@
       <ul class="md-nav__list">
         
           <li class="md-nav__item">
-  <a href="#bug-fixes_10" class="md-nav__link">
+  <a href="#bug-fixes_11" class="md-nav__link">
     <span class="md-ellipsis">
       Bug Fixes
     </span>
@@ -1048,7 +1081,7 @@
       <ul class="md-nav__list">
         
           <li class="md-nav__item">
-  <a href="#features_14" class="md-nav__link">
+  <a href="#features_15" class="md-nav__link">
     <span class="md-ellipsis">
       Features
     </span>
@@ -1057,7 +1090,7 @@
 </li>
         
           <li class="md-nav__item">
-  <a href="#bug-fixes_11" class="md-nav__link">
+  <a href="#bug-fixes_12" class="md-nav__link">
     <span class="md-ellipsis">
       Bug Fixes
     </span>
@@ -1081,7 +1114,7 @@
       <ul class="md-nav__list">
         
           <li class="md-nav__item">
-  <a href="#features_15" class="md-nav__link">
+  <a href="#features_16" class="md-nav__link">
     <span class="md-ellipsis">
       Features
     </span>
@@ -1105,7 +1138,7 @@
       <ul class="md-nav__list">
         
           <li class="md-nav__item">
-  <a href="#bug-fixes_12" class="md-nav__link">
+  <a href="#bug-fixes_13" class="md-nav__link">
     <span class="md-ellipsis">
       Bug Fixes
     </span>
@@ -1129,7 +1162,7 @@
       <ul class="md-nav__list">
         
           <li class="md-nav__item">
-  <a href="#bug-fixes_13" class="md-nav__link">
+  <a href="#bug-fixes_14" class="md-nav__link">
     <span class="md-ellipsis">
       Bug Fixes
     </span>
@@ -1153,7 +1186,7 @@
       <ul class="md-nav__list">
         
           <li class="md-nav__item">
-  <a href="#bug-fixes_14" class="md-nav__link">
+  <a href="#bug-fixes_15" class="md-nav__link">
     <span class="md-ellipsis">
       Bug Fixes
     </span>
@@ -1177,7 +1210,7 @@
       <ul class="md-nav__list">
         
           <li class="md-nav__item">
-  <a href="#bug-fixes_15" class="md-nav__link">
+  <a href="#bug-fixes_16" class="md-nav__link">
     <span class="md-ellipsis">
       Bug Fixes
     </span>
@@ -1201,7 +1234,7 @@
       <ul class="md-nav__list">
         
           <li class="md-nav__item">
-  <a href="#features_16" class="md-nav__link">
+  <a href="#features_17" class="md-nav__link">
     <span class="md-ellipsis">
       Features
     </span>
@@ -1225,7 +1258,7 @@
       <ul class="md-nav__list">
         
           <li class="md-nav__item">
-  <a href="#bug-fixes_16" class="md-nav__link">
+  <a href="#bug-fixes_17" class="md-nav__link">
     <span class="md-ellipsis">
       Bug Fixes
     </span>
@@ -1249,7 +1282,7 @@
       <ul class="md-nav__list">
         
           <li class="md-nav__item">
-  <a href="#features_17" class="md-nav__link">
+  <a href="#features_18" class="md-nav__link">
     <span class="md-ellipsis">
       Features
     </span>
@@ -1273,7 +1306,7 @@
       <ul class="md-nav__list">
         
           <li class="md-nav__item">
-  <a href="#features_18" class="md-nav__link">
+  <a href="#features_19" class="md-nav__link">
     <span class="md-ellipsis">
       Features
     </span>
@@ -1297,7 +1330,7 @@
       <ul class="md-nav__list">
         
           <li class="md-nav__item">
-  <a href="#features_19" class="md-nav__link">
+  <a href="#features_20" class="md-nav__link">
     <span class="md-ellipsis">
       Features
     </span>
@@ -1321,7 +1354,7 @@
       <ul class="md-nav__list">
         
           <li class="md-nav__item">
-  <a href="#bug-fixes_17" class="md-nav__link">
+  <a href="#bug-fixes_18" class="md-nav__link">
     <span class="md-ellipsis">
       Bug Fixes
     </span>
@@ -1345,7 +1378,7 @@
       <ul class="md-nav__list">
         
           <li class="md-nav__item">
-  <a href="#features_20" class="md-nav__link">
+  <a href="#features_21" class="md-nav__link">
     <span class="md-ellipsis">
       Features
     </span>
@@ -1369,7 +1402,7 @@
       <ul class="md-nav__list">
         
           <li class="md-nav__item">
-  <a href="#features_21" class="md-nav__link">
+  <a href="#features_22" class="md-nav__link">
     <span class="md-ellipsis">
       Features
     </span>
@@ -1393,7 +1426,7 @@
       <ul class="md-nav__list">
         
           <li class="md-nav__item">
-  <a href="#features_22" class="md-nav__link">
+  <a href="#features_23" class="md-nav__link">
     <span class="md-ellipsis">
       Features
     </span>
@@ -1417,7 +1450,7 @@
       <ul class="md-nav__list">
         
           <li class="md-nav__item">
-  <a href="#features_23" class="md-nav__link">
+  <a href="#features_24" class="md-nav__link">
     <span class="md-ellipsis">
       Features
     </span>
@@ -1441,7 +1474,7 @@
       <ul class="md-nav__list">
         
           <li class="md-nav__item">
-  <a href="#bug-fixes_18" class="md-nav__link">
+  <a href="#bug-fixes_19" class="md-nav__link">
     <span class="md-ellipsis">
       Bug Fixes
     </span>
@@ -1465,7 +1498,7 @@
       <ul class="md-nav__list">
         
           <li class="md-nav__item">
-  <a href="#features_24" class="md-nav__link">
+  <a href="#features_25" class="md-nav__link">
     <span class="md-ellipsis">
       Features
     </span>
@@ -1489,7 +1522,7 @@
       <ul class="md-nav__list">
         
           <li class="md-nav__item">
-  <a href="#features_25" class="md-nav__link">
+  <a href="#features_26" class="md-nav__link">
     <span class="md-ellipsis">
       Features
     </span>
@@ -1498,7 +1531,7 @@
 </li>
         
           <li class="md-nav__item">
-  <a href="#bug-fixes_19" class="md-nav__link">
+  <a href="#bug-fixes_20" class="md-nav__link">
     <span class="md-ellipsis">
       Bug Fixes
     </span>
@@ -1522,7 +1555,7 @@
       <ul class="md-nav__list">
         
           <li class="md-nav__item">
-  <a href="#bug-fixes_20" class="md-nav__link">
+  <a href="#bug-fixes_21" class="md-nav__link">
     <span class="md-ellipsis">
       Bug Fixes
     </span>
@@ -1546,7 +1579,7 @@
       <ul class="md-nav__list">
         
           <li class="md-nav__item">
-  <a href="#features_26" class="md-nav__link">
+  <a href="#features_27" class="md-nav__link">
     <span class="md-ellipsis">
       Features
     </span>
@@ -1570,7 +1603,7 @@
       <ul class="md-nav__list">
         
           <li class="md-nav__item">
-  <a href="#features_27" class="md-nav__link">
+  <a href="#features_28" class="md-nav__link">
     <span class="md-ellipsis">
       Features
     </span>
@@ -1594,7 +1627,7 @@
       <ul class="md-nav__list">
         
           <li class="md-nav__item">
-  <a href="#features_28" class="md-nav__link">
+  <a href="#features_29" class="md-nav__link">
     <span class="md-ellipsis">
       Features
     </span>
@@ -1603,7 +1636,7 @@
 </li>
         
           <li class="md-nav__item">
-  <a href="#bug-fixes_21" class="md-nav__link">
+  <a href="#bug-fixes_22" class="md-nav__link">
     <span class="md-ellipsis">
       Bug Fixes
     </span>
@@ -1627,7 +1660,7 @@
       <ul class="md-nav__list">
         
           <li class="md-nav__item">
-  <a href="#bug-fixes_22" class="md-nav__link">
+  <a href="#bug-fixes_23" class="md-nav__link">
     <span class="md-ellipsis">
       Bug Fixes
     </span>
@@ -1651,7 +1684,7 @@
       <ul class="md-nav__list">
         
           <li class="md-nav__item">
-  <a href="#features_29" class="md-nav__link">
+  <a href="#features_30" class="md-nav__link">
     <span class="md-ellipsis">
       Features
     </span>
@@ -1675,7 +1708,7 @@
       <ul class="md-nav__list">
         
           <li class="md-nav__item">
-  <a href="#features_30" class="md-nav__link">
+  <a href="#features_31" class="md-nav__link">
     <span class="md-ellipsis">
       Features
     </span>
@@ -1699,7 +1732,7 @@
       <ul class="md-nav__list">
         
           <li class="md-nav__item">
-  <a href="#features_31" class="md-nav__link">
+  <a href="#features_32" class="md-nav__link">
     <span class="md-ellipsis">
       Features
     </span>
@@ -1723,7 +1756,7 @@
       <ul class="md-nav__list">
         
           <li class="md-nav__item">
-  <a href="#bug-fixes_23" class="md-nav__link">
+  <a href="#bug-fixes_24" class="md-nav__link">
     <span class="md-ellipsis">
       Bug Fixes
     </span>
@@ -1747,7 +1780,7 @@
       <ul class="md-nav__list">
         
           <li class="md-nav__item">
-  <a href="#features_32" class="md-nav__link">
+  <a href="#features_33" class="md-nav__link">
     <span class="md-ellipsis">
       Features
     </span>
@@ -1771,7 +1804,7 @@
       <ul class="md-nav__list">
         
           <li class="md-nav__item">
-  <a href="#features_33" class="md-nav__link">
+  <a href="#features_34" class="md-nav__link">
     <span class="md-ellipsis">
       Features
     </span>
@@ -1780,7 +1813,7 @@
 </li>
         
           <li class="md-nav__item">
-  <a href="#bug-fixes_24" class="md-nav__link">
+  <a href="#bug-fixes_25" class="md-nav__link">
     <span class="md-ellipsis">
       Bug Fixes
     </span>
@@ -1804,7 +1837,7 @@
       <ul class="md-nav__list">
         
           <li class="md-nav__item">
-  <a href="#bug-fixes_25" class="md-nav__link">
+  <a href="#bug-fixes_26" class="md-nav__link">
     <span class="md-ellipsis">
       Bug Fixes
     </span>
@@ -1828,7 +1861,7 @@
       <ul class="md-nav__list">
         
           <li class="md-nav__item">
-  <a href="#features_34" class="md-nav__link">
+  <a href="#features_35" class="md-nav__link">
     <span class="md-ellipsis">
       Features
     </span>
@@ -1837,7 +1870,7 @@
 </li>
         
           <li class="md-nav__item">
-  <a href="#bug-fixes_26" class="md-nav__link">
+  <a href="#bug-fixes_27" class="md-nav__link">
     <span class="md-ellipsis">
       Bug Fixes
     </span>
@@ -1861,7 +1894,7 @@
       <ul class="md-nav__list">
         
           <li class="md-nav__item">
-  <a href="#features_35" class="md-nav__link">
+  <a href="#features_36" class="md-nav__link">
     <span class="md-ellipsis">
       Features
     </span>
@@ -1870,7 +1903,7 @@
 </li>
         
           <li class="md-nav__item">
-  <a href="#bug-fixes_27" class="md-nav__link">
+  <a href="#bug-fixes_28" class="md-nav__link">
     <span class="md-ellipsis">
       Bug Fixes
     </span>
@@ -1894,7 +1927,7 @@
       <ul class="md-nav__list">
         
           <li class="md-nav__item">
-  <a href="#features_36" class="md-nav__link">
+  <a href="#features_37" class="md-nav__link">
     <span class="md-ellipsis">
       Features
     </span>
@@ -1918,7 +1951,7 @@
       <ul class="md-nav__list">
         
           <li class="md-nav__item">
-  <a href="#features_37" class="md-nav__link">
+  <a href="#features_38" class="md-nav__link">
     <span class="md-ellipsis">
       Features
     </span>
@@ -1927,7 +1960,7 @@
 </li>
         
           <li class="md-nav__item">
-  <a href="#bug-fixes_28" class="md-nav__link">
+  <a href="#bug-fixes_29" class="md-nav__link">
     <span class="md-ellipsis">
       Bug Fixes
     </span>
@@ -1951,7 +1984,7 @@
       <ul class="md-nav__list">
         
           <li class="md-nav__item">
-  <a href="#features_38" class="md-nav__link">
+  <a href="#features_39" class="md-nav__link">
     <span class="md-ellipsis">
       Features
     </span>
@@ -1975,7 +2008,7 @@
       <ul class="md-nav__list">
         
           <li class="md-nav__item">
-  <a href="#features_39" class="md-nav__link">
+  <a href="#features_40" class="md-nav__link">
     <span class="md-ellipsis">
       Features
     </span>
@@ -1999,7 +2032,7 @@
       <ul class="md-nav__list">
         
           <li class="md-nav__item">
-  <a href="#bug-fixes_29" class="md-nav__link">
+  <a href="#bug-fixes_30" class="md-nav__link">
     <span class="md-ellipsis">
       Bug Fixes
     </span>
@@ -2023,7 +2056,7 @@
       <ul class="md-nav__list">
         
           <li class="md-nav__item">
-  <a href="#bug-fixes_30" class="md-nav__link">
+  <a href="#bug-fixes_31" class="md-nav__link">
     <span class="md-ellipsis">
       Bug Fixes
     </span>
@@ -2047,7 +2080,7 @@
       <ul class="md-nav__list">
         
           <li class="md-nav__item">
-  <a href="#bug-fixes_31" class="md-nav__link">
+  <a href="#bug-fixes_32" class="md-nav__link">
     <span class="md-ellipsis">
       Bug Fixes
     </span>
@@ -2071,7 +2104,7 @@
       <ul class="md-nav__list">
         
           <li class="md-nav__item">
-  <a href="#bug-fixes_32" class="md-nav__link">
+  <a href="#bug-fixes_33" class="md-nav__link">
     <span class="md-ellipsis">
       Bug Fixes
     </span>
@@ -2095,7 +2128,7 @@
       <ul class="md-nav__list">
         
           <li class="md-nav__item">
-  <a href="#bug-fixes_33" class="md-nav__link">
+  <a href="#bug-fixes_34" class="md-nav__link">
     <span class="md-ellipsis">
       Bug Fixes
     </span>
@@ -2119,7 +2152,7 @@
       <ul class="md-nav__list">
         
           <li class="md-nav__item">
-  <a href="#bug-fixes_34" class="md-nav__link">
+  <a href="#bug-fixes_35" class="md-nav__link">
     <span class="md-ellipsis">
       Bug Fixes
     </span>
@@ -2143,7 +2176,7 @@
       <ul class="md-nav__list">
         
           <li class="md-nav__item">
-  <a href="#features_40" class="md-nav__link">
+  <a href="#features_41" class="md-nav__link">
     <span class="md-ellipsis">
       Features
     </span>
@@ -2167,7 +2200,7 @@
       <ul class="md-nav__list">
         
           <li class="md-nav__item">
-  <a href="#features_41" class="md-nav__link">
+  <a href="#features_42" class="md-nav__link">
     <span class="md-ellipsis">
       Features
     </span>
@@ -2176,7 +2209,7 @@
 </li>
         
           <li class="md-nav__item">
-  <a href="#bug-fixes_35" class="md-nav__link">
+  <a href="#bug-fixes_36" class="md-nav__link">
     <span class="md-ellipsis">
       Bug Fixes
     </span>
@@ -2200,7 +2233,7 @@
       <ul class="md-nav__list">
         
           <li class="md-nav__item">
-  <a href="#bug-fixes_36" class="md-nav__link">
+  <a href="#bug-fixes_37" class="md-nav__link">
     <span class="md-ellipsis">
       Bug Fixes
     </span>
@@ -2224,7 +2257,7 @@
       <ul class="md-nav__list">
         
           <li class="md-nav__item">
-  <a href="#features_42" class="md-nav__link">
+  <a href="#features_43" class="md-nav__link">
     <span class="md-ellipsis">
       Features
     </span>
@@ -2233,7 +2266,7 @@
 </li>
         
           <li class="md-nav__item">
-  <a href="#bug-fixes_37" class="md-nav__link">
+  <a href="#bug-fixes_38" class="md-nav__link">
     <span class="md-ellipsis">
       Bug Fixes
     </span>
@@ -2257,7 +2290,7 @@
       <ul class="md-nav__list">
         
           <li class="md-nav__item">
-  <a href="#features_43" class="md-nav__link">
+  <a href="#features_44" class="md-nav__link">
     <span class="md-ellipsis">
       Features
     </span>
@@ -2281,7 +2314,7 @@
       <ul class="md-nav__list">
         
           <li class="md-nav__item">
-  <a href="#bug-fixes_38" class="md-nav__link">
+  <a href="#bug-fixes_39" class="md-nav__link">
     <span class="md-ellipsis">
       Bug Fixes
     </span>
@@ -2305,7 +2338,7 @@
       <ul class="md-nav__list">
         
           <li class="md-nav__item">
-  <a href="#features_44" class="md-nav__link">
+  <a href="#features_45" class="md-nav__link">
     <span class="md-ellipsis">
       Features
     </span>
@@ -2314,7 +2347,7 @@
 </li>
         
           <li class="md-nav__item">
-  <a href="#bug-fixes_39" class="md-nav__link">
+  <a href="#bug-fixes_40" class="md-nav__link">
     <span class="md-ellipsis">
       Bug Fixes
     </span>
@@ -2338,7 +2371,7 @@
       <ul class="md-nav__list">
         
           <li class="md-nav__item">
-  <a href="#features_45" class="md-nav__link">
+  <a href="#features_46" class="md-nav__link">
     <span class="md-ellipsis">
       Features
     </span>
@@ -2362,7 +2395,7 @@
       <ul class="md-nav__list">
         
           <li class="md-nav__item">
-  <a href="#features_46" class="md-nav__link">
+  <a href="#features_47" class="md-nav__link">
     <span class="md-ellipsis">
       Features
     </span>
@@ -2371,7 +2404,7 @@
 </li>
         
           <li class="md-nav__item">
-  <a href="#bug-fixes_40" class="md-nav__link">
+  <a href="#bug-fixes_41" class="md-nav__link">
     <span class="md-ellipsis">
       Bug Fixes
     </span>
@@ -2395,7 +2428,7 @@
       <ul class="md-nav__list">
         
           <li class="md-nav__item">
-  <a href="#bug-fixes_41" class="md-nav__link">
+  <a href="#bug-fixes_42" class="md-nav__link">
     <span class="md-ellipsis">
       Bug Fixes
     </span>
@@ -2419,7 +2452,7 @@
       <ul class="md-nav__list">
         
           <li class="md-nav__item">
-  <a href="#features_47" class="md-nav__link">
+  <a href="#features_48" class="md-nav__link">
     <span class="md-ellipsis">
       Features
     </span>
@@ -2428,7 +2461,7 @@
 </li>
         
           <li class="md-nav__item">
-  <a href="#bug-fixes_42" class="md-nav__link">
+  <a href="#bug-fixes_43" class="md-nav__link">
     <span class="md-ellipsis">
       Bug Fixes
     </span>
@@ -2452,7 +2485,7 @@
       <ul class="md-nav__list">
         
           <li class="md-nav__item">
-  <a href="#features_48" class="md-nav__link">
+  <a href="#features_49" class="md-nav__link">
     <span class="md-ellipsis">
       Features
     </span>
@@ -2476,7 +2509,7 @@
       <ul class="md-nav__list">
         
           <li class="md-nav__item">
-  <a href="#bug-fixes_43" class="md-nav__link">
+  <a href="#bug-fixes_44" class="md-nav__link">
     <span class="md-ellipsis">
       Bug Fixes
     </span>
@@ -2500,7 +2533,7 @@
       <ul class="md-nav__list">
         
           <li class="md-nav__item">
-  <a href="#features_49" class="md-nav__link">
+  <a href="#features_50" class="md-nav__link">
     <span class="md-ellipsis">
       Features
     </span>
@@ -2509,7 +2542,7 @@
 </li>
         
           <li class="md-nav__item">
-  <a href="#bug-fixes_44" class="md-nav__link">
+  <a href="#bug-fixes_45" class="md-nav__link">
     <span class="md-ellipsis">
       Bug Fixes
     </span>
@@ -2533,7 +2566,7 @@
       <ul class="md-nav__list">
         
           <li class="md-nav__item">
-  <a href="#features_50" class="md-nav__link">
+  <a href="#features_51" class="md-nav__link">
     <span class="md-ellipsis">
       Features
     </span>
@@ -2557,7 +2590,7 @@
       <ul class="md-nav__list">
         
           <li class="md-nav__item">
-  <a href="#features_51" class="md-nav__link">
+  <a href="#features_52" class="md-nav__link">
     <span class="md-ellipsis">
       Features
     </span>
@@ -2581,7 +2614,7 @@
       <ul class="md-nav__list">
         
           <li class="md-nav__item">
-  <a href="#features_52" class="md-nav__link">
+  <a href="#features_53" class="md-nav__link">
     <span class="md-ellipsis">
       Features
     </span>
@@ -2590,7 +2623,7 @@
 </li>
         
           <li class="md-nav__item">
-  <a href="#bug-fixes_45" class="md-nav__link">
+  <a href="#bug-fixes_46" class="md-nav__link">
     <span class="md-ellipsis">
       Bug Fixes
     </span>
@@ -2614,7 +2647,7 @@
       <ul class="md-nav__list">
         
           <li class="md-nav__item">
-  <a href="#features_53" class="md-nav__link">
+  <a href="#features_54" class="md-nav__link">
     <span class="md-ellipsis">
       Features
     </span>
@@ -2638,7 +2671,7 @@
       <ul class="md-nav__list">
         
           <li class="md-nav__item">
-  <a href="#bug-fixes_46" class="md-nav__link">
+  <a href="#bug-fixes_47" class="md-nav__link">
     <span class="md-ellipsis">
       Bug Fixes
     </span>
@@ -2662,7 +2695,7 @@
       <ul class="md-nav__list">
         
           <li class="md-nav__item">
-  <a href="#bug-fixes_47" class="md-nav__link">
+  <a href="#bug-fixes_48" class="md-nav__link">
     <span class="md-ellipsis">
       Bug Fixes
     </span>
@@ -2686,7 +2719,7 @@
       <ul class="md-nav__list">
         
           <li class="md-nav__item">
-  <a href="#features_54" class="md-nav__link">
+  <a href="#features_55" class="md-nav__link">
     <span class="md-ellipsis">
       Features
     </span>
@@ -2695,7 +2728,7 @@
 </li>
         
           <li class="md-nav__item">
-  <a href="#bug-fixes_48" class="md-nav__link">
+  <a href="#bug-fixes_49" class="md-nav__link">
     <span class="md-ellipsis">
       Bug Fixes
     </span>
@@ -2719,7 +2752,7 @@
       <ul class="md-nav__list">
         
           <li class="md-nav__item">
-  <a href="#features_55" class="md-nav__link">
+  <a href="#features_56" class="md-nav__link">
     <span class="md-ellipsis">
       Features
     </span>
@@ -2743,7 +2776,7 @@
       <ul class="md-nav__list">
         
           <li class="md-nav__item">
-  <a href="#features_56" class="md-nav__link">
+  <a href="#features_57" class="md-nav__link">
     <span class="md-ellipsis">
       Features
     </span>
@@ -2971,13 +3004,13 @@
     <ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
       
         <li class="md-nav__item">
-  <a href="#1560-2024-12-19" class="md-nav__link">
+  <a href="#1570-2024-12-20" class="md-nav__link">
     <span class="md-ellipsis">
-      1.56.0 (2024-12-19)
+      1.57.0 (2024-12-20)
     </span>
   </a>
   
-    <nav class="md-nav" aria-label="1.56.0 (2024-12-19)">
+    <nav class="md-nav" aria-label="1.57.0 (2024-12-20)">
       <ul class="md-nav__list">
         
           <li class="md-nav__item">
@@ -2987,6 +3020,15 @@
     </span>
   </a>
   
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#bug-fixes" class="md-nav__link">
+    <span class="md-ellipsis">
+      Bug Fixes
+    </span>
+  </a>
+  
 </li>
         
       </ul>
@@ -2995,13 +3037,13 @@
 </li>
       
         <li class="md-nav__item">
-  <a href="#1550-2024-12-12" class="md-nav__link">
+  <a href="#1560-2024-12-19" class="md-nav__link">
     <span class="md-ellipsis">
-      1.55.0 (2024-12-12)
+      1.56.0 (2024-12-19)
     </span>
   </a>
   
-    <nav class="md-nav" aria-label="1.55.0 (2024-12-12)">
+    <nav class="md-nav" aria-label="1.56.0 (2024-12-19)">
       <ul class="md-nav__list">
         
           <li class="md-nav__item">
@@ -3011,10 +3053,34 @@
     </span>
   </a>
   
+</li>
+        
+      </ul>
+    </nav>
+  
+</li>
+      
+        <li class="md-nav__item">
+  <a href="#1550-2024-12-12" class="md-nav__link">
+    <span class="md-ellipsis">
+      1.55.0 (2024-12-12)
+    </span>
+  </a>
+  
+    <nav class="md-nav" aria-label="1.55.0 (2024-12-12)">
+      <ul class="md-nav__list">
+        
+          <li class="md-nav__item">
+  <a href="#features_2" class="md-nav__link">
+    <span class="md-ellipsis">
+      Features
+    </span>
+  </a>
+  
 </li>
         
           <li class="md-nav__item">
-  <a href="#bug-fixes" class="md-nav__link">
+  <a href="#bug-fixes_1" class="md-nav__link">
     <span class="md-ellipsis">
       Bug Fixes
     </span>
@@ -3038,7 +3104,7 @@
       <ul class="md-nav__list">
         
           <li class="md-nav__item">
-  <a href="#features_2" class="md-nav__link">
+  <a href="#features_3" class="md-nav__link">
     <span class="md-ellipsis">
       Features
     </span>
@@ -3062,7 +3128,7 @@
       <ul class="md-nav__list">
         
           <li class="md-nav__item">
-  <a href="#features_3" class="md-nav__link">
+  <a href="#features_4" class="md-nav__link">
     <span class="md-ellipsis">
       Features
     </span>
@@ -3086,7 +3152,7 @@
       <ul class="md-nav__list">
         
           <li class="md-nav__item">
-  <a href="#features_4" class="md-nav__link">
+  <a href="#features_5" class="md-nav__link">
     <span class="md-ellipsis">
       Features
     </span>
@@ -3110,7 +3176,7 @@
       <ul class="md-nav__list">
         
           <li class="md-nav__item">
-  <a href="#features_5" class="md-nav__link">
+  <a href="#features_6" class="md-nav__link">
     <span class="md-ellipsis">
       Features
     </span>
@@ -3134,7 +3200,7 @@
       <ul class="md-nav__list">
         
           <li class="md-nav__item">
-  <a href="#features_6" class="md-nav__link">
+  <a href="#features_7" class="md-nav__link">
     <span class="md-ellipsis">
       Features
     </span>
@@ -3143,7 +3209,7 @@
 </li>
         
           <li class="md-nav__item">
-  <a href="#bug-fixes_1" class="md-nav__link">
+  <a href="#bug-fixes_2" class="md-nav__link">
     <span class="md-ellipsis">
       Bug Fixes
     </span>
@@ -3167,7 +3233,7 @@
       <ul class="md-nav__list">
         
           <li class="md-nav__item">
-  <a href="#features_7" class="md-nav__link">
+  <a href="#features_8" class="md-nav__link">
     <span class="md-ellipsis">
       Features
     </span>
@@ -3176,7 +3242,7 @@
 </li>
         
           <li class="md-nav__item">
-  <a href="#bug-fixes_2" class="md-nav__link">
+  <a href="#bug-fixes_3" class="md-nav__link">
     <span class="md-ellipsis">
       Bug Fixes
     </span>
@@ -3200,7 +3266,7 @@
       <ul class="md-nav__list">
         
           <li class="md-nav__item">
-  <a href="#features_8" class="md-nav__link">
+  <a href="#features_9" class="md-nav__link">
     <span class="md-ellipsis">
       Features
     </span>
@@ -3209,7 +3275,7 @@
 </li>
         
           <li class="md-nav__item">
-  <a href="#bug-fixes_3" class="md-nav__link">
+  <a href="#bug-fixes_4" class="md-nav__link">
     <span class="md-ellipsis">
       Bug Fixes
     </span>
@@ -3233,7 +3299,7 @@
       <ul class="md-nav__list">
         
           <li class="md-nav__item">
-  <a href="#features_9" class="md-nav__link">
+  <a href="#features_10" class="md-nav__link">
     <span class="md-ellipsis">
       Features
     </span>
@@ -3242,7 +3308,7 @@
 </li>
         
           <li class="md-nav__item">
-  <a href="#bug-fixes_4" class="md-nav__link">
+  <a href="#bug-fixes_5" class="md-nav__link">
     <span class="md-ellipsis">
       Bug Fixes
     </span>
@@ -3266,7 +3332,7 @@
       <ul class="md-nav__list">
         
           <li class="md-nav__item">
-  <a href="#features_10" class="md-nav__link">
+  <a href="#features_11" class="md-nav__link">
     <span class="md-ellipsis">
       Features
     </span>
@@ -3275,7 +3341,7 @@
 </li>
         
           <li class="md-nav__item">
-  <a href="#bug-fixes_5" class="md-nav__link">
+  <a href="#bug-fixes_6" class="md-nav__link">
     <span class="md-ellipsis">
       Bug Fixes
     </span>
@@ -3299,7 +3365,7 @@
       <ul class="md-nav__list">
         
           <li class="md-nav__item">
-  <a href="#bug-fixes_6" class="md-nav__link">
+  <a href="#bug-fixes_7" class="md-nav__link">
     <span class="md-ellipsis">
       Bug Fixes
     </span>
@@ -3323,7 +3389,7 @@
       <ul class="md-nav__list">
         
           <li class="md-nav__item">
-  <a href="#bug-fixes_7" class="md-nav__link">
+  <a href="#bug-fixes_8" class="md-nav__link">
     <span class="md-ellipsis">
       Bug Fixes
     </span>
@@ -3347,7 +3413,7 @@
       <ul class="md-nav__list">
         
           <li class="md-nav__item">
-  <a href="#features_11" class="md-nav__link">
+  <a href="#features_12" class="md-nav__link">
     <span class="md-ellipsis">
       Features
     </span>
@@ -3371,7 +3437,7 @@
       <ul class="md-nav__list">
         
           <li class="md-nav__item">
-  <a href="#bug-fixes_8" class="md-nav__link">
+  <a href="#bug-fixes_9" class="md-nav__link">
     <span class="md-ellipsis">
       Bug Fixes
     </span>
@@ -3395,7 +3461,7 @@
       <ul class="md-nav__list">
         
           <li class="md-nav__item">
-  <a href="#features_12" class="md-nav__link">
+  <a href="#features_13" class="md-nav__link">
     <span class="md-ellipsis">
       Features
     </span>
@@ -3404,7 +3470,7 @@
 </li>
         
           <li class="md-nav__item">
-  <a href="#bug-fixes_9" class="md-nav__link">
+  <a href="#bug-fixes_10" class="md-nav__link">
     <span class="md-ellipsis">
       Bug Fixes
     </span>
@@ -3428,7 +3494,7 @@
       <ul class="md-nav__list">
         
           <li class="md-nav__item">
-  <a href="#features_13" class="md-nav__link">
+  <a href="#features_14" class="md-nav__link">
     <span class="md-ellipsis">
       Features
     </span>
@@ -3452,7 +3518,7 @@
       <ul class="md-nav__list">
         
           <li class="md-nav__item">
-  <a href="#bug-fixes_10" class="md-nav__link">
+  <a href="#bug-fixes_11" class="md-nav__link">
     <span class="md-ellipsis">
       Bug Fixes
     </span>
@@ -3476,7 +3542,7 @@
       <ul class="md-nav__list">
         
           <li class="md-nav__item">
-  <a href="#features_14" class="md-nav__link">
+  <a href="#features_15" class="md-nav__link">
     <span class="md-ellipsis">
       Features
     </span>
@@ -3485,7 +3551,7 @@
 </li>
         
           <li class="md-nav__item">
-  <a href="#bug-fixes_11" class="md-nav__link">
+  <a href="#bug-fixes_12" class="md-nav__link">
     <span class="md-ellipsis">
       Bug Fixes
     </span>
@@ -3509,7 +3575,7 @@
       <ul class="md-nav__list">
         
           <li class="md-nav__item">
-  <a href="#features_15" class="md-nav__link">
+  <a href="#features_16" class="md-nav__link">
     <span class="md-ellipsis">
       Features
     </span>
@@ -3533,7 +3599,7 @@
       <ul class="md-nav__list">
         
           <li class="md-nav__item">
-  <a href="#bug-fixes_12" class="md-nav__link">
+  <a href="#bug-fixes_13" class="md-nav__link">
     <span class="md-ellipsis">
       Bug Fixes
     </span>
@@ -3557,7 +3623,7 @@
       <ul class="md-nav__list">
         
           <li class="md-nav__item">
-  <a href="#bug-fixes_13" class="md-nav__link">
+  <a href="#bug-fixes_14" class="md-nav__link">
     <span class="md-ellipsis">
       Bug Fixes
     </span>
@@ -3581,7 +3647,7 @@
       <ul class="md-nav__list">
         
           <li class="md-nav__item">
-  <a href="#bug-fixes_14" class="md-nav__link">
+  <a href="#bug-fixes_15" class="md-nav__link">
     <span class="md-ellipsis">
       Bug Fixes
     </span>
@@ -3605,7 +3671,7 @@
       <ul class="md-nav__list">
         
           <li class="md-nav__item">
-  <a href="#bug-fixes_15" class="md-nav__link">
+  <a href="#bug-fixes_16" class="md-nav__link">
     <span class="md-ellipsis">
       Bug Fixes
     </span>
@@ -3629,7 +3695,7 @@
       <ul class="md-nav__list">
         
           <li class="md-nav__item">
-  <a href="#features_16" class="md-nav__link">
+  <a href="#features_17" class="md-nav__link">
     <span class="md-ellipsis">
       Features
     </span>
@@ -3653,7 +3719,7 @@
       <ul class="md-nav__list">
         
           <li class="md-nav__item">
-  <a href="#bug-fixes_16" class="md-nav__link">
+  <a href="#bug-fixes_17" class="md-nav__link">
     <span class="md-ellipsis">
       Bug Fixes
     </span>
@@ -3677,7 +3743,7 @@
       <ul class="md-nav__list">
         
           <li class="md-nav__item">
-  <a href="#features_17" class="md-nav__link">
+  <a href="#features_18" class="md-nav__link">
     <span class="md-ellipsis">
       Features
     </span>
@@ -3701,7 +3767,7 @@
       <ul class="md-nav__list">
         
           <li class="md-nav__item">
-  <a href="#features_18" class="md-nav__link">
+  <a href="#features_19" class="md-nav__link">
     <span class="md-ellipsis">
       Features
     </span>
@@ -3725,7 +3791,7 @@
       <ul class="md-nav__list">
         
           <li class="md-nav__item">
-  <a href="#features_19" class="md-nav__link">
+  <a href="#features_20" class="md-nav__link">
     <span class="md-ellipsis">
       Features
     </span>
@@ -3749,7 +3815,7 @@
       <ul class="md-nav__list">
         
           <li class="md-nav__item">
-  <a href="#bug-fixes_17" class="md-nav__link">
+  <a href="#bug-fixes_18" class="md-nav__link">
     <span class="md-ellipsis">
       Bug Fixes
     </span>
@@ -3773,7 +3839,7 @@
       <ul class="md-nav__list">
         
           <li class="md-nav__item">
-  <a href="#features_20" class="md-nav__link">
+  <a href="#features_21" class="md-nav__link">
     <span class="md-ellipsis">
       Features
     </span>
@@ -3797,7 +3863,7 @@
       <ul class="md-nav__list">
         
           <li class="md-nav__item">
-  <a href="#features_21" class="md-nav__link">
+  <a href="#features_22" class="md-nav__link">
     <span class="md-ellipsis">
       Features
     </span>
@@ -3821,7 +3887,7 @@
       <ul class="md-nav__list">
         
           <li class="md-nav__item">
-  <a href="#features_22" class="md-nav__link">
+  <a href="#features_23" class="md-nav__link">
     <span class="md-ellipsis">
       Features
     </span>
@@ -3845,7 +3911,7 @@
       <ul class="md-nav__list">
         
           <li class="md-nav__item">
-  <a href="#features_23" class="md-nav__link">
+  <a href="#features_24" class="md-nav__link">
     <span class="md-ellipsis">
       Features
     </span>
@@ -3869,7 +3935,7 @@
       <ul class="md-nav__list">
         
           <li class="md-nav__item">
-  <a href="#bug-fixes_18" class="md-nav__link">
+  <a href="#bug-fixes_19" class="md-nav__link">
     <span class="md-ellipsis">
       Bug Fixes
     </span>
@@ -3893,7 +3959,7 @@
       <ul class="md-nav__list">
         
           <li class="md-nav__item">
-  <a href="#features_24" class="md-nav__link">
+  <a href="#features_25" class="md-nav__link">
     <span class="md-ellipsis">
       Features
     </span>
@@ -3917,7 +3983,7 @@
       <ul class="md-nav__list">
         
           <li class="md-nav__item">
-  <a href="#features_25" class="md-nav__link">
+  <a href="#features_26" class="md-nav__link">
     <span class="md-ellipsis">
       Features
     </span>
@@ -3926,7 +3992,7 @@
 </li>
         
           <li class="md-nav__item">
-  <a href="#bug-fixes_19" class="md-nav__link">
+  <a href="#bug-fixes_20" class="md-nav__link">
     <span class="md-ellipsis">
       Bug Fixes
     </span>
@@ -3950,7 +4016,7 @@
       <ul class="md-nav__list">
         
           <li class="md-nav__item">
-  <a href="#bug-fixes_20" class="md-nav__link">
+  <a href="#bug-fixes_21" class="md-nav__link">
     <span class="md-ellipsis">
       Bug Fixes
     </span>
@@ -3974,7 +4040,7 @@
       <ul class="md-nav__list">
         
           <li class="md-nav__item">
-  <a href="#features_26" class="md-nav__link">
+  <a href="#features_27" class="md-nav__link">
     <span class="md-ellipsis">
       Features
     </span>
@@ -3998,7 +4064,7 @@
       <ul class="md-nav__list">
         
           <li class="md-nav__item">
-  <a href="#features_27" class="md-nav__link">
+  <a href="#features_28" class="md-nav__link">
     <span class="md-ellipsis">
       Features
     </span>
@@ -4022,7 +4088,7 @@
       <ul class="md-nav__list">
         
           <li class="md-nav__item">
-  <a href="#features_28" class="md-nav__link">
+  <a href="#features_29" class="md-nav__link">
     <span class="md-ellipsis">
       Features
     </span>
@@ -4031,7 +4097,7 @@
 </li>
         
           <li class="md-nav__item">
-  <a href="#bug-fixes_21" class="md-nav__link">
+  <a href="#bug-fixes_22" class="md-nav__link">
     <span class="md-ellipsis">
       Bug Fixes
     </span>
@@ -4055,7 +4121,7 @@
       <ul class="md-nav__list">
         
           <li class="md-nav__item">
-  <a href="#bug-fixes_22" class="md-nav__link">
+  <a href="#bug-fixes_23" class="md-nav__link">
     <span class="md-ellipsis">
       Bug Fixes
     </span>
@@ -4079,7 +4145,7 @@
       <ul class="md-nav__list">
         
           <li class="md-nav__item">
-  <a href="#features_29" class="md-nav__link">
+  <a href="#features_30" class="md-nav__link">
     <span class="md-ellipsis">
       Features
     </span>
@@ -4103,7 +4169,7 @@
       <ul class="md-nav__list">
         
           <li class="md-nav__item">
-  <a href="#features_30" class="md-nav__link">
+  <a href="#features_31" class="md-nav__link">
     <span class="md-ellipsis">
       Features
     </span>
@@ -4127,7 +4193,7 @@
       <ul class="md-nav__list">
         
           <li class="md-nav__item">
-  <a href="#features_31" class="md-nav__link">
+  <a href="#features_32" class="md-nav__link">
     <span class="md-ellipsis">
       Features
     </span>
@@ -4151,7 +4217,7 @@
       <ul class="md-nav__list">
         
           <li class="md-nav__item">
-  <a href="#bug-fixes_23" class="md-nav__link">
+  <a href="#bug-fixes_24" class="md-nav__link">
     <span class="md-ellipsis">
       Bug Fixes
     </span>
@@ -4175,7 +4241,7 @@
       <ul class="md-nav__list">
         
           <li class="md-nav__item">
-  <a href="#features_32" class="md-nav__link">
+  <a href="#features_33" class="md-nav__link">
     <span class="md-ellipsis">
       Features
     </span>
@@ -4199,7 +4265,7 @@
       <ul class="md-nav__list">
         
           <li class="md-nav__item">
-  <a href="#features_33" class="md-nav__link">
+  <a href="#features_34" class="md-nav__link">
     <span class="md-ellipsis">
       Features
     </span>
@@ -4208,7 +4274,7 @@
 </li>
         
           <li class="md-nav__item">
-  <a href="#bug-fixes_24" class="md-nav__link">
+  <a href="#bug-fixes_25" class="md-nav__link">
     <span class="md-ellipsis">
       Bug Fixes
     </span>
@@ -4232,7 +4298,7 @@
       <ul class="md-nav__list">
         
           <li class="md-nav__item">
-  <a href="#bug-fixes_25" class="md-nav__link">
+  <a href="#bug-fixes_26" class="md-nav__link">
     <span class="md-ellipsis">
       Bug Fixes
     </span>
@@ -4256,7 +4322,7 @@
       <ul class="md-nav__list">
         
           <li class="md-nav__item">
-  <a href="#features_34" class="md-nav__link">
+  <a href="#features_35" class="md-nav__link">
     <span class="md-ellipsis">
       Features
     </span>
@@ -4265,7 +4331,7 @@
 </li>
         
           <li class="md-nav__item">
-  <a href="#bug-fixes_26" class="md-nav__link">
+  <a href="#bug-fixes_27" class="md-nav__link">
     <span class="md-ellipsis">
       Bug Fixes
     </span>
@@ -4289,7 +4355,7 @@
       <ul class="md-nav__list">
         
           <li class="md-nav__item">
-  <a href="#features_35" class="md-nav__link">
+  <a href="#features_36" class="md-nav__link">
     <span class="md-ellipsis">
       Features
     </span>
@@ -4298,7 +4364,7 @@
 </li>
         
           <li class="md-nav__item">
-  <a href="#bug-fixes_27" class="md-nav__link">
+  <a href="#bug-fixes_28" class="md-nav__link">
     <span class="md-ellipsis">
       Bug Fixes
     </span>
@@ -4322,7 +4388,7 @@
       <ul class="md-nav__list">
         
           <li class="md-nav__item">
-  <a href="#features_36" class="md-nav__link">
+  <a href="#features_37" class="md-nav__link">
     <span class="md-ellipsis">
       Features
     </span>
@@ -4346,7 +4412,7 @@
       <ul class="md-nav__list">
         
           <li class="md-nav__item">
-  <a href="#features_37" class="md-nav__link">
+  <a href="#features_38" class="md-nav__link">
     <span class="md-ellipsis">
       Features
     </span>
@@ -4355,7 +4421,7 @@
 </li>
         
           <li class="md-nav__item">
-  <a href="#bug-fixes_28" class="md-nav__link">
+  <a href="#bug-fixes_29" class="md-nav__link">
     <span class="md-ellipsis">
       Bug Fixes
     </span>
@@ -4379,7 +4445,7 @@
       <ul class="md-nav__list">
         
           <li class="md-nav__item">
-  <a href="#features_38" class="md-nav__link">
+  <a href="#features_39" class="md-nav__link">
     <span class="md-ellipsis">
       Features
     </span>
@@ -4403,7 +4469,7 @@
       <ul class="md-nav__list">
         
           <li class="md-nav__item">
-  <a href="#features_39" class="md-nav__link">
+  <a href="#features_40" class="md-nav__link">
     <span class="md-ellipsis">
       Features
     </span>
@@ -4427,7 +4493,7 @@
       <ul class="md-nav__list">
         
           <li class="md-nav__item">
-  <a href="#bug-fixes_29" class="md-nav__link">
+  <a href="#bug-fixes_30" class="md-nav__link">
     <span class="md-ellipsis">
       Bug Fixes
     </span>
@@ -4451,7 +4517,7 @@
       <ul class="md-nav__list">
         
           <li class="md-nav__item">
-  <a href="#bug-fixes_30" class="md-nav__link">
+  <a href="#bug-fixes_31" class="md-nav__link">
     <span class="md-ellipsis">
       Bug Fixes
     </span>
@@ -4475,7 +4541,7 @@
       <ul class="md-nav__list">
         
           <li class="md-nav__item">
-  <a href="#bug-fixes_31" class="md-nav__link">
+  <a href="#bug-fixes_32" class="md-nav__link">
     <span class="md-ellipsis">
       Bug Fixes
     </span>
@@ -4499,7 +4565,7 @@
       <ul class="md-nav__list">
         
           <li class="md-nav__item">
-  <a href="#bug-fixes_32" class="md-nav__link">
+  <a href="#bug-fixes_33" class="md-nav__link">
     <span class="md-ellipsis">
       Bug Fixes
     </span>
@@ -4523,7 +4589,7 @@
       <ul class="md-nav__list">
         
           <li class="md-nav__item">
-  <a href="#bug-fixes_33" class="md-nav__link">
+  <a href="#bug-fixes_34" class="md-nav__link">
     <span class="md-ellipsis">
       Bug Fixes
     </span>
@@ -4547,7 +4613,7 @@
       <ul class="md-nav__list">
         
           <li class="md-nav__item">
-  <a href="#bug-fixes_34" class="md-nav__link">
+  <a href="#bug-fixes_35" class="md-nav__link">
     <span class="md-ellipsis">
       Bug Fixes
     </span>
@@ -4571,7 +4637,7 @@
       <ul class="md-nav__list">
         
           <li class="md-nav__item">
-  <a href="#features_40" class="md-nav__link">
+  <a href="#features_41" class="md-nav__link">
     <span class="md-ellipsis">
       Features
     </span>
@@ -4595,7 +4661,7 @@
       <ul class="md-nav__list">
         
           <li class="md-nav__item">
-  <a href="#features_41" class="md-nav__link">
+  <a href="#features_42" class="md-nav__link">
     <span class="md-ellipsis">
       Features
     </span>
@@ -4604,7 +4670,7 @@
 </li>
         
           <li class="md-nav__item">
-  <a href="#bug-fixes_35" class="md-nav__link">
+  <a href="#bug-fixes_36" class="md-nav__link">
     <span class="md-ellipsis">
       Bug Fixes
     </span>
@@ -4628,7 +4694,7 @@
       <ul class="md-nav__list">
         
           <li class="md-nav__item">
-  <a href="#bug-fixes_36" class="md-nav__link">
+  <a href="#bug-fixes_37" class="md-nav__link">
     <span class="md-ellipsis">
       Bug Fixes
     </span>
@@ -4652,7 +4718,7 @@
       <ul class="md-nav__list">
         
           <li class="md-nav__item">
-  <a href="#features_42" class="md-nav__link">
+  <a href="#features_43" class="md-nav__link">
     <span class="md-ellipsis">
       Features
     </span>
@@ -4661,7 +4727,7 @@
 </li>
         
           <li class="md-nav__item">
-  <a href="#bug-fixes_37" class="md-nav__link">
+  <a href="#bug-fixes_38" class="md-nav__link">
     <span class="md-ellipsis">
       Bug Fixes
     </span>
@@ -4685,7 +4751,7 @@
       <ul class="md-nav__list">
         
           <li class="md-nav__item">
-  <a href="#features_43" class="md-nav__link">
+  <a href="#features_44" class="md-nav__link">
     <span class="md-ellipsis">
       Features
     </span>
@@ -4709,7 +4775,7 @@
       <ul class="md-nav__list">
         
           <li class="md-nav__item">
-  <a href="#bug-fixes_38" class="md-nav__link">
+  <a href="#bug-fixes_39" class="md-nav__link">
     <span class="md-ellipsis">
       Bug Fixes
     </span>
@@ -4733,7 +4799,7 @@
       <ul class="md-nav__list">
         
           <li class="md-nav__item">
-  <a href="#features_44" class="md-nav__link">
+  <a href="#features_45" class="md-nav__link">
     <span class="md-ellipsis">
       Features
     </span>
@@ -4742,7 +4808,7 @@
 </li>
         
           <li class="md-nav__item">
-  <a href="#bug-fixes_39" class="md-nav__link">
+  <a href="#bug-fixes_40" class="md-nav__link">
     <span class="md-ellipsis">
       Bug Fixes
     </span>
@@ -4766,7 +4832,7 @@
       <ul class="md-nav__list">
         
           <li class="md-nav__item">
-  <a href="#features_45" class="md-nav__link">
+  <a href="#features_46" class="md-nav__link">
     <span class="md-ellipsis">
       Features
     </span>
@@ -4790,7 +4856,7 @@
       <ul class="md-nav__list">
         
           <li class="md-nav__item">
-  <a href="#features_46" class="md-nav__link">
+  <a href="#features_47" class="md-nav__link">
     <span class="md-ellipsis">
       Features
     </span>
@@ -4799,7 +4865,7 @@
 </li>
         
           <li class="md-nav__item">
-  <a href="#bug-fixes_40" class="md-nav__link">
+  <a href="#bug-fixes_41" class="md-nav__link">
     <span class="md-ellipsis">
       Bug Fixes
     </span>
@@ -4823,7 +4889,7 @@
       <ul class="md-nav__list">
         
           <li class="md-nav__item">
-  <a href="#bug-fixes_41" class="md-nav__link">
+  <a href="#bug-fixes_42" class="md-nav__link">
     <span class="md-ellipsis">
       Bug Fixes
     </span>
@@ -4847,7 +4913,7 @@
       <ul class="md-nav__list">
         
           <li class="md-nav__item">
-  <a href="#features_47" class="md-nav__link">
+  <a href="#features_48" class="md-nav__link">
     <span class="md-ellipsis">
       Features
     </span>
@@ -4856,7 +4922,7 @@
 </li>
         
           <li class="md-nav__item">
-  <a href="#bug-fixes_42" class="md-nav__link">
+  <a href="#bug-fixes_43" class="md-nav__link">
     <span class="md-ellipsis">
       Bug Fixes
     </span>
@@ -4880,7 +4946,7 @@
       <ul class="md-nav__list">
         
           <li class="md-nav__item">
-  <a href="#features_48" class="md-nav__link">
+  <a href="#features_49" class="md-nav__link">
     <span class="md-ellipsis">
       Features
     </span>
@@ -4904,7 +4970,7 @@
       <ul class="md-nav__list">
         
           <li class="md-nav__item">
-  <a href="#bug-fixes_43" class="md-nav__link">
+  <a href="#bug-fixes_44" class="md-nav__link">
     <span class="md-ellipsis">
       Bug Fixes
     </span>
@@ -4928,7 +4994,7 @@
       <ul class="md-nav__list">
         
           <li class="md-nav__item">
-  <a href="#features_49" class="md-nav__link">
+  <a href="#features_50" class="md-nav__link">
     <span class="md-ellipsis">
       Features
     </span>
@@ -4937,7 +5003,7 @@
 </li>
         
           <li class="md-nav__item">
-  <a href="#bug-fixes_44" class="md-nav__link">
+  <a href="#bug-fixes_45" class="md-nav__link">
     <span class="md-ellipsis">
       Bug Fixes
     </span>
@@ -4961,7 +5027,7 @@
       <ul class="md-nav__list">
         
           <li class="md-nav__item">
-  <a href="#features_50" class="md-nav__link">
+  <a href="#features_51" class="md-nav__link">
     <span class="md-ellipsis">
       Features
     </span>
@@ -4985,7 +5051,7 @@
       <ul class="md-nav__list">
         
           <li class="md-nav__item">
-  <a href="#features_51" class="md-nav__link">
+  <a href="#features_52" class="md-nav__link">
     <span class="md-ellipsis">
       Features
     </span>
@@ -5009,7 +5075,7 @@
       <ul class="md-nav__list">
         
           <li class="md-nav__item">
-  <a href="#features_52" class="md-nav__link">
+  <a href="#features_53" class="md-nav__link">
     <span class="md-ellipsis">
       Features
     </span>
@@ -5018,7 +5084,7 @@
 </li>
         
           <li class="md-nav__item">
-  <a href="#bug-fixes_45" class="md-nav__link">
+  <a href="#bug-fixes_46" class="md-nav__link">
     <span class="md-ellipsis">
       Bug Fixes
     </span>
@@ -5042,7 +5108,7 @@
       <ul class="md-nav__list">
         
           <li class="md-nav__item">
-  <a href="#features_53" class="md-nav__link">
+  <a href="#features_54" class="md-nav__link">
     <span class="md-ellipsis">
       Features
     </span>
@@ -5066,7 +5132,7 @@
       <ul class="md-nav__list">
         
           <li class="md-nav__item">
-  <a href="#bug-fixes_46" class="md-nav__link">
+  <a href="#bug-fixes_47" class="md-nav__link">
     <span class="md-ellipsis">
       Bug Fixes
     </span>
@@ -5090,7 +5156,7 @@
       <ul class="md-nav__list">
         
           <li class="md-nav__item">
-  <a href="#bug-fixes_47" class="md-nav__link">
+  <a href="#bug-fixes_48" class="md-nav__link">
     <span class="md-ellipsis">
       Bug Fixes
     </span>
@@ -5114,7 +5180,7 @@
       <ul class="md-nav__list">
         
           <li class="md-nav__item">
-  <a href="#features_54" class="md-nav__link">
+  <a href="#features_55" class="md-nav__link">
     <span class="md-ellipsis">
       Features
     </span>
@@ -5123,7 +5189,7 @@
 </li>
         
           <li class="md-nav__item">
-  <a href="#bug-fixes_48" class="md-nav__link">
+  <a href="#bug-fixes_49" class="md-nav__link">
     <span class="md-ellipsis">
       Bug Fixes
     </span>
@@ -5147,7 +5213,7 @@
       <ul class="md-nav__list">
         
           <li class="md-nav__item">
-  <a href="#features_55" class="md-nav__link">
+  <a href="#features_56" class="md-nav__link">
     <span class="md-ellipsis">
       Features
     </span>
@@ -5171,7 +5237,7 @@
       <ul class="md-nav__list">
         
           <li class="md-nav__item">
-  <a href="#features_56" class="md-nav__link">
+  <a href="#features_57" class="md-nav__link">
     <span class="md-ellipsis">
       Features
     </span>
@@ -5216,128 +5282,138 @@
 
 
 <h1 id="changelog">Changelog</h1>
-<h2 id="1560-2024-12-19"><a href="https://github.com/danielo515/obsidian-modal-form/compare/1.55.0...1.56.0">1.56.0</a> (2024-12-19)</h2>
+<h2 id="1570-2024-12-20"><a href="https://github.com/danielo515/obsidian-modal-form/compare/1.56.0...1.57.0">1.57.0</a> (2024-12-20)</h2>
 <h3 id="features">Features</h3>
 <ul>
+<li><strong>parser:</strong> add support for parsing transformations (<a href="https://github.com/danielo515/obsidian-modal-form/commit/2dbe84c95da65504172a68ad974174b9c5bd48b7">2dbe84c</a>)</li>
+<li><strong>template:</strong> execute transformations when applying templates (<a href="https://github.com/danielo515/obsidian-modal-form/commit/7552a2a6095ff1fd51c1b0010abfc08edc53ffa3">7552a2a</a>)</li>
+</ul>
+<h3 id="bug-fixes">Bug Fixes</h3>
+<ul>
+<li>import forms not working (<a href="https://github.com/danielo515/obsidian-modal-form/commit/e9c64c29e0fbae3602cc4e0ab03f0d9c3fd928ed">e9c64c2</a>)</li>
+</ul>
+<h2 id="1560-2024-12-19"><a href="https://github.com/danielo515/obsidian-modal-form/compare/1.55.0...1.56.0">1.56.0</a> (2024-12-19)</h2>
+<h3 id="features_1">Features</h3>
+<ul>
 <li><strong>core:</strong> template service to use any available template engine to post-process templates (<a href="https://github.com/danielo515/obsidian-modal-form/commit/a3f9d4e1e6eb648ecf49d5c3b73a3f3d605756df">a3f9d4e</a>)</li>
 <li><strong>templates:</strong> ask templater to run on form template insertion (<a href="https://github.com/danielo515/obsidian-modal-form/commit/2a10a25133df105aa035bffbdf001e8bd7da15da">2a10a25</a>)</li>
 <li><strong>templates:</strong> offer retry on templater errors (<a href="https://github.com/danielo515/obsidian-modal-form/commit/64dae864a6d36e54038857b958cd21bf9f1fc412">64dae86</a>)</li>
 <li><strong>templates:</strong> post-process templates using templater (<a href="https://github.com/danielo515/obsidian-modal-form/commit/ea01cd93569771c4b21f7b70cc76928a957ac1aa">ea01cd9</a>)</li>
 </ul>
 <h2 id="1550-2024-12-12"><a href="https://github.com/danielo515/obsidian-modal-form/compare/1.54.0...1.55.0">1.55.0</a> (2024-12-12)</h2>
-<h3 id="features_1">Features</h3>
+<h3 id="features_2">Features</h3>
 <ul>
 <li><strong>input:</strong> you can define a parent folder on the folder input (<a href="https://github.com/danielo515/obsidian-modal-form/commit/d208648ba49cb8674b48b0f3f1eca9bfb9aed5ad">d208648</a>)</li>
 </ul>
-<h3 id="bug-fixes">Bug Fixes</h3>
+<h3 id="bug-fixes_1">Bug Fixes</h3>
 <ul>
 <li>remove deprecated usages (<a href="https://github.com/danielo515/obsidian-modal-form/commit/96aed30449aa0ac7006b34188559a9ec820b4c53">96aed30</a>)</li>
 </ul>
 <h2 id="1540-2024-12-11"><a href="https://github.com/danielo515/obsidian-modal-form/compare/1.53.0...1.54.0">1.54.0</a> (2024-12-11)</h2>
-<h3 id="features_2">Features</h3>
+<h3 id="features_3">Features</h3>
 <ul>
 <li><strong>builder:</strong> File input builder (<a href="https://github.com/danielo515/obsidian-modal-form/commit/48b62af80cfdb2ca81793c9258a2872367e7144f">48b62af</a>)</li>
 <li><strong>input:</strong> file input schema and rendering (<a href="https://github.com/danielo515/obsidian-modal-form/commit/b4682ff73b0bbe9fe038db0fc19eca55f6bcfade">b4682ff</a>)</li>
 </ul>
 <h2 id="1530-2024-12-09"><a href="https://github.com/danielo515/obsidian-modal-form/compare/1.52.0...1.53.0">1.53.0</a> (2024-12-09)</h2>
-<h3 id="features_3">Features</h3>
+<h3 id="features_4">Features</h3>
 <ul>
 <li><strong>input:</strong> added Image input type (<a href="https://github.com/danielo515/obsidian-modal-form/commit/cfc0cad039ac2d23f329dafd328d5c46b9f512fc">cfc0cad</a>)</li>
 </ul>
 <h2 id="1520-2024-09-29"><a href="https://github.com/danielo515/obsidian-modal-form/compare/1.51.0...1.52.0">1.52.0</a> (2024-09-29)</h2>
-<h3 id="features_4">Features</h3>
+<h3 id="features_5">Features</h3>
 <ul>
 <li><strong>form-runtime:</strong> markdown block input (<a href="https://github.com/danielo515/obsidian-modal-form/commit/567d3911ea308291eb4e231adaa11f21e2b7cd78">567d391</a>)</li>
 </ul>
 <h2 id="1510-2024-09-13"><a href="https://github.com/danielo515/obsidian-modal-form/compare/1.50.0...1.51.0">1.51.0</a> (2024-09-13)</h2>
-<h3 id="features_5">Features</h3>
+<h3 id="features_6">Features</h3>
 <ul>
 <li>create an example vault (<a href="https://github.com/danielo515/obsidian-modal-form/commit/6c1f7c88aac77cb7753e4cd605fd7a869d34e4b2">6c1f7c8</a>)</li>
 <li><strong>form-builder:</strong> add ability to hide fields to the UI (<a href="https://github.com/danielo515/obsidian-modal-form/commit/1af3b2ddda71d5f95b27309382c849300f940123">1af3b2d</a>)</li>
 <li><strong>form-engine:</strong> basic inputs can be hidden (<a href="https://github.com/danielo515/obsidian-modal-form/commit/6b5d17fb7feaf056dc835bacc9a5ba8ec18e0d53">6b5d17f</a>)</li>
 </ul>
 <h2 id="1500-2024-07-10"><a href="https://github.com/danielo515/obsidian-modal-form/compare/1.49.0...1.50.0">1.50.0</a> (2024-07-10)</h2>
-<h3 id="features_6">Features</h3>
+<h3 id="features_7">Features</h3>
 <ul>
 <li>logger instance (<a href="https://github.com/danielo515/obsidian-modal-form/commit/a30a9ff1d12def22fbbec93eb25f34bfe7987180">a30a9ff</a>)</li>
 </ul>
-<h3 id="bug-fixes_1">Bug Fixes</h3>
+<h3 id="bug-fixes_2">Bug Fixes</h3>
 <ul>
 <li>provide a logger implementation that only shows debug messages on debug (<a href="https://github.com/danielo515/obsidian-modal-form/commit/72faa206cd2467c72cb53e77c2251dc2003ba872">72faa20</a>)</li>
 </ul>
 <h2 id="1490-2024-07-05"><a href="https://github.com/danielo515/obsidian-modal-form/compare/1.48.0...1.49.0">1.49.0</a> (2024-07-05)</h2>
-<h3 id="features_7">Features</h3>
+<h3 id="features_8">Features</h3>
 <ul>
 <li><strong>runtime:</strong> allow the select to be used as condition for other  fields (<a href="https://github.com/danielo515/obsidian-modal-form/commit/0d23e0b8b56877f566b753f738f36497b40c5c0d">0d23e0b</a>)</li>
 </ul>
-<h3 id="bug-fixes_2">Bug Fixes</h3>
+<h3 id="bug-fixes_3">Bug Fixes</h3>
 <ul>
 <li><strong>builder:</strong> properly save the isSet condition (<a href="https://github.com/danielo515/obsidian-modal-form/commit/1ffe48882612cfb03da0427316dbc4daa7caeb86">1ffe488</a>)</li>
 </ul>
 <h2 id="1480-2024-07-02"><a href="https://github.com/danielo515/obsidian-modal-form/compare/1.47.0...1.48.0">1.48.0</a> (2024-07-02)</h2>
-<h3 id="features_8">Features</h3>
+<h3 id="features_9">Features</h3>
 <ul>
 <li>conditional input form builder (<a href="https://github.com/danielo515/obsidian-modal-form/commit/5f6a9befea605507dc7e4f5eaed42d620da72954">5f6a9be</a>)</li>
 <li><strong>runtime:</strong> conditional fields v1 (<a href="https://github.com/danielo515/obsidian-modal-form/commit/4ab141ec537089f3e9cbd052843e3b45fec9aea6">4ab141e</a>)</li>
 <li><strong>runtime:</strong> show conditional errors in the form (<a href="https://github.com/danielo515/obsidian-modal-form/commit/83a1060aef020133f2723f090c09603a058e010e">83a1060</a>)</li>
 </ul>
-<h3 id="bug-fixes_3">Bug Fixes</h3>
+<h3 id="bug-fixes_4">Bug Fixes</h3>
 <ul>
 <li>ConditionInput finally works as expected (<a href="https://github.com/danielo515/obsidian-modal-form/commit/c5d5fff647b1ae8fb2bcd8a168b97a90b48ff8b1">c5d5fff</a>)</li>
 </ul>
 <h2 id="1470-2024-06-22"><a href="https://github.com/danielo515/obsidian-modal-form/compare/1.46.0...1.47.0">1.47.0</a> (2024-06-22)</h2>
-<h3 id="features_9">Features</h3>
+<h3 id="features_10">Features</h3>
 <ul>
 <li>group error messages (<a href="https://github.com/danielo515/obsidian-modal-form/commit/e0e94231b3d6034144934aa71cb14f523e79d349">e0e9423</a>)</li>
 <li>remove completely the old way of rendering fields (<a href="https://github.com/danielo515/obsidian-modal-form/commit/801d3318efc100c25b35536432f955b98b45652d">801d331</a>)</li>
 <li><strong>runtime:</strong> svelte versions of DocumentBlock and InputNote (<a href="https://github.com/danielo515/obsidian-modal-form/commit/968d230c3643fb788647171f8c9bfbba282e85cf">968d230</a>)</li>
 </ul>
-<h3 id="bug-fixes_4">Bug Fixes</h3>
+<h3 id="bug-fixes_5">Bug Fixes</h3>
 <ul>
 <li><strong>runtime:</strong> input tag in svelte (<a href="https://github.com/danielo515/obsidian-modal-form/commit/879aba9cf411cc94f235096018bd2d8ebbc0931b">879aba9</a>)</li>
 <li><strong>runtime:</strong> svelte wrappers for obsidian settings (<a href="https://github.com/danielo515/obsidian-modal-form/commit/37f52364b0282f641c165f199f323465623157d9">37f5236</a>)</li>
 </ul>
 <h2 id="1460-2024-06-17"><a href="https://github.com/danielo515/obsidian-modal-form/compare/1.45.2...1.46.0">1.46.0</a> (2024-06-17)</h2>
-<h3 id="features_10">Features</h3>
+<h3 id="features_11">Features</h3>
 <ul>
 <li><strong>util:</strong> insert a form template into current note command (<a href="https://github.com/danielo515/obsidian-modal-form/commit/d60fe825aaee824c3f9f506675e86af2f5ba4e91">d60fe82</a>)</li>
 </ul>
-<h3 id="bug-fixes_5">Bug Fixes</h3>
+<h3 id="bug-fixes_6">Bug Fixes</h3>
 <ul>
 <li><strong>templater:</strong> remove empty lines (<a href="https://github.com/danielo515/obsidian-modal-form/commit/eda92a2a62350035ca599fe1bef14749b44b346e">eda92a2</a>)</li>
 </ul>
 <h2 id="1452-2024-06-10"><a href="https://github.com/danielo515/obsidian-modal-form/compare/1.45.1...1.45.2">1.45.2</a> (2024-06-10)</h2>
-<h3 id="bug-fixes_6">Bug Fixes</h3>
+<h3 id="bug-fixes_7">Bug Fixes</h3>
 <ul>
 <li><strong>runtime:</strong> better weights in file suggestions  (<a href="https://github.com/danielo515/obsidian-modal-form/commit/aac26d13a369869918e4d857a3db832c8025d4a2">aac26d1</a>), closes <a href="https://github.com/danielo515/obsidian-modal-form/issues/272">#272</a></li>
 </ul>
 <h2 id="1451-2024-06-04"><a href="https://github.com/danielo515/obsidian-modal-form/compare/1.45.0...1.45.1">1.45.1</a> (2024-06-04)</h2>
-<h3 id="bug-fixes_7">Bug Fixes</h3>
+<h3 id="bug-fixes_8">Bug Fixes</h3>
 <ul>
 <li><strong>templater:</strong> flex wrap (<a href="https://github.com/danielo515/obsidian-modal-form/commit/4aed8409626f2049805a777aac35a7934028d1c8">4aed840</a>)</li>
 </ul>
 <h2 id="1450-2024-06-04"><a href="https://github.com/danielo515/obsidian-modal-form/compare/1.44.1...1.45.0">1.45.0</a> (2024-06-04)</h2>
-<h3 id="features_11">Features</h3>
+<h3 id="features_12">Features</h3>
 <ul>
 <li><strong>templater:</strong> customize result name in template builder (<a href="https://github.com/danielo515/obsidian-modal-form/commit/16a2297371e2efc449b838a42dd838e4ed419193">16a2297</a>)</li>
 <li><strong>templater:</strong> easily build template body (<a href="https://github.com/danielo515/obsidian-modal-form/commit/b7051362f34a2d785581e0265b7ef7ebc7b1b3de">b705136</a>)</li>
 </ul>
 <h2 id="1441-2024-05-31"><a href="https://github.com/danielo515/obsidian-modal-form/compare/1.44.0...1.44.1">1.44.1</a> (2024-05-31)</h2>
-<h3 id="bug-fixes_8">Bug Fixes</h3>
+<h3 id="bug-fixes_9">Bug Fixes</h3>
 <ul>
 <li>show title in the template builder (<a href="https://github.com/danielo515/obsidian-modal-form/commit/012901d86a2408429c4ebde0c93e2bdf531f4850">012901d</a>)</li>
 </ul>
 <h2 id="1440-2024-05-30"><a href="https://github.com/danielo515/obsidian-modal-form/compare/1.43.0...1.44.0">1.44.0</a> (2024-05-30)</h2>
-<h3 id="features_12">Features</h3>
+<h3 id="features_13">Features</h3>
 <ul>
 <li>more customizations in the generated template (<a href="https://github.com/danielo515/obsidian-modal-form/commit/6db7d2914c099a1e14a670d73f9d5cbe84ed7cd3">6db7d29</a>)</li>
 </ul>
-<h3 id="bug-fixes_9">Bug Fixes</h3>
+<h3 id="bug-fixes_10">Bug Fixes</h3>
 <ul>
 <li>easy toggle all for fields to include in frontmatter (<a href="https://github.com/danielo515/obsidian-modal-form/commit/8bf4fb4a30e9076d91d182e7a4359bba6426c5e3">8bf4fb4</a>)</li>
 </ul>
 <h2 id="1430-2024-05-30"><a href="https://github.com/danielo515/obsidian-modal-form/compare/1.42.1...1.43.0">1.43.0</a> (2024-05-30)</h2>
-<h3 id="features_13">Features</h3>
+<h3 id="features_14">Features</h3>
 <ul>
 <li>ability to open template builder form UI (<a href="https://github.com/danielo515/obsidian-modal-form/commit/c6663ffc07c00494451b4f7b0b28e7d43efa7781">c6663ff</a>)</li>
 <li>add a view for template builder (<a href="https://github.com/danielo515/obsidian-modal-form/commit/f32ebfb95d34dca54a34551954c2c3c3fd5e5354">f32ebfb</a>)</li>
@@ -5346,21 +5422,21 @@ <h3 id="features_13">Features</h3>
 <li><strong>std:</strong> updateFirst for Array (<a href="https://github.com/danielo515/obsidian-modal-form/commit/e6f28e13441e629d04ab0d9a4807ed420171e419">e6f28e1</a>)</li>
 </ul>
 <h2 id="1421-2024-05-14"><a href="https://github.com/danielo515/obsidian-modal-form/compare/1.42.0...1.42.1">1.42.1</a> (2024-05-14)</h2>
-<h3 id="bug-fixes_10">Bug Fixes</h3>
+<h3 id="bug-fixes_11">Bug Fixes</h3>
 <ul>
 <li>set initial value of fixed-source select fields, if provided (<a href="https://github.com/danielo515/obsidian-modal-form/commit/88642268b78f7f6e01e7716e178d3c20ce2652fe">8864226</a>)</li>
 </ul>
 <h2 id="1420-2024-05-13"><a href="https://github.com/danielo515/obsidian-modal-form/compare/1.41.0...1.42.0">1.42.0</a> (2024-05-13)</h2>
-<h3 id="features_14">Features</h3>
+<h3 id="features_15">Features</h3>
 <ul>
 <li>cancel esc button for cancel the form (<a href="https://github.com/danielo515/obsidian-modal-form/commit/ea350bf0db7fc2f9c084cfede229401d9223e57b">ea350bf</a>)</li>
 </ul>
-<h3 id="bug-fixes_11">Bug Fixes</h3>
+<h3 id="bug-fixes_12">Bug Fixes</h3>
 <ul>
 <li><strong>formEngine:</strong> gracefully handle the close of the form (<a href="https://github.com/danielo515/obsidian-modal-form/commit/a398882e13cd1c837718af8d09a83f63c5ec5ca1">a398882</a>)</li>
 </ul>
 <h2 id="1410-2024-05-10"><a href="https://github.com/danielo515/obsidian-modal-form/compare/1.40.4...1.41.0">1.41.0</a> (2024-05-10)</h2>
-<h3 id="features_15">Features</h3>
+<h3 id="features_16">Features</h3>
 <ul>
 <li><strong>input:</strong> dataview input can be fully async (<a href="https://github.com/danielo515/obsidian-modal-form/commit/cac23bb10aeb74b31b060f261948226cff854d63">cac23bb</a>)</li>
 <li><strong>input:</strong> document block is async (<a href="https://github.com/danielo515/obsidian-modal-form/commit/1e23a1b3992ccc7e8f54365cea9cd63a1fe7f23c">1e23a1b</a>)</li>
@@ -5369,80 +5445,80 @@ <h3 id="features_15">Features</h3>
 <li><strong>suggesters:</strong> make SafeDataviewQuery async (<a href="https://github.com/danielo515/obsidian-modal-form/commit/239a4d5be2d16e4d76baa0ae218fae746ea7649a">239a4d5</a>)</li>
 </ul>
 <h2 id="1404-2024-04-25"><a href="https://github.com/danielo515/obsidian-modal-form/compare/1.40.3...1.40.4">1.40.4</a> (2024-04-25)</h2>
-<h3 id="bug-fixes_12">Bug Fixes</h3>
+<h3 id="bug-fixes_13">Bug Fixes</h3>
 <ul>
 <li>make the editor headers stick only on big screens (<a href="https://github.com/danielo515/obsidian-modal-form/commit/4193246f14b2f7165c58ff2829b9fbf0b550dfe4">4193246</a>)</li>
 </ul>
 <h2 id="1403-2024-04-20"><a href="https://github.com/danielo515/obsidian-modal-form/compare/1.40.2...1.40.3">1.40.3</a> (2024-04-20)</h2>
-<h3 id="bug-fixes_13">Bug Fixes</h3>
+<h3 id="bug-fixes_14">Bug Fixes</h3>
 <ul>
 <li>allow decimal inputs for number fields (<a href="https://github.com/danielo515/obsidian-modal-form/commit/b70e99af2164c0a50aae016d23d939618361642e">b70e99a</a>), closes <a href="https://github.com/danielo515/obsidian-modal-form/issues/237">#237</a></li>
 </ul>
 <h2 id="1402-2024-01-22"><a href="https://github.com/danielo515/obsidian-modal-form/compare/1.40.1...1.40.2">1.40.2</a> (2024-01-22)</h2>
-<h3 id="bug-fixes_14">Bug Fixes</h3>
+<h3 id="bug-fixes_15">Bug Fixes</h3>
 <ul>
 <li>support html in the document_block (<a href="https://github.com/danielo515/obsidian-modal-form/commit/171793791d66e818b166a90d4701632d232218b0">1717937</a>)</li>
 </ul>
 <h2 id="1401-2024-01-21"><a href="https://github.com/danielo515/obsidian-modal-form/compare/1.40.0...1.40.1">1.40.1</a> (2024-01-21)</h2>
-<h3 id="bug-fixes_15">Bug Fixes</h3>
+<h3 id="bug-fixes_16">Bug Fixes</h3>
 <ul>
 <li>a bit better import UI (<a href="https://github.com/danielo515/obsidian-modal-form/commit/024b5131bb1a6814863a28fdb7791a5cb7be3445">024b513</a>)</li>
 <li>button to open import modal from form manager (<a href="https://github.com/danielo515/obsidian-modal-form/commit/1cc834e24a64bd05c3a487f03aaf4ad154b0a69f">1cc834e</a>)</li>
 </ul>
 <h2 id="1400-2024-01-21"><a href="https://github.com/danielo515/obsidian-modal-form/compare/1.39.1...1.40.0">1.40.0</a> (2024-01-21)</h2>
-<h3 id="features_16">Features</h3>
+<h3 id="features_17">Features</h3>
 <ul>
 <li><strong>API:</strong> expose some utils (<a href="https://github.com/danielo515/obsidian-modal-form/commit/eb54365e38c6f3313dae09dde42c39d5b4bce5b4">eb54365</a>)</li>
 <li>import form modal (<a href="https://github.com/danielo515/obsidian-modal-form/commit/a8449837a850f15cf6c5e9aff0529f8dad24686e">a844983</a>)</li>
 <li><strong>import:</strong> ability to edit forms imported from JSON (<a href="https://github.com/danielo515/obsidian-modal-form/commit/6cdb1041114ac10e1ec5c580ce02b90d6568a745">6cdb104</a>)</li>
 </ul>
 <h2 id="1391-2024-01-17"><a href="https://github.com/danielo515/obsidian-modal-form/compare/1.39.0...1.39.1">1.39.1</a> (2024-01-17)</h2>
-<h3 id="bug-fixes_16">Bug Fixes</h3>
+<h3 id="bug-fixes_17">Bug Fixes</h3>
 <ul>
 <li>tag should allow unknown values (<a href="https://github.com/danielo515/obsidian-modal-form/commit/4dec09018f27c637c4f3c59f44f54dc968f15df8">4dec090</a>)</li>
 </ul>
 <h2 id="1390-2024-01-14"><a href="https://github.com/danielo515/obsidian-modal-form/compare/1.38.0...1.39.0">1.39.0</a> (2024-01-14)</h2>
-<h3 id="features_17">Features</h3>
+<h3 id="features_18">Features</h3>
 <ul>
 <li>multi select notes uses the new notes input (better UI and search) (<a href="https://github.com/danielo515/obsidian-modal-form/commit/6c3e1e5b068573826e564d8648f6cf2714f61b1a">6c3e1e5</a>)</li>
 </ul>
 <h2 id="1380-2024-01-13"><a href="https://github.com/danielo515/obsidian-modal-form/compare/1.37.0...1.38.0">1.38.0</a> (2024-01-13)</h2>
-<h3 id="features_18">Features</h3>
+<h3 id="features_19">Features</h3>
 <ul>
 <li><strong>core:</strong> enrich_tfile utility function (<a href="https://github.com/danielo515/obsidian-modal-form/commit/1cf4508be2ee6ac52d22a8e7c17fb5728ddafbf0">1cf4508</a>)</li>
 <li><strong>form:</strong> the input file is now fuzzy over path and tags. It shows a nicer UI that includes the path (<a href="https://github.com/danielo515/obsidian-modal-form/commit/38dc4b3060b089bc8829bde2f34ff198830a283e">38dc4b3</a>)</li>
 <li><strong>input:</strong> note suggest shows the parent folder of the note (<a href="https://github.com/danielo515/obsidian-modal-form/commit/6409ebf217730f33b223e7e6b03d5f7a70abe8ac">6409ebf</a>)</li>
 </ul>
 <h2 id="1370-2024-01-06"><a href="https://github.com/danielo515/obsidian-modal-form/compare/1.36.1...1.37.0">1.37.0</a> (2024-01-06)</h2>
-<h3 id="features_19">Features</h3>
+<h3 id="features_20">Features</h3>
 <ul>
 <li>command to directly edit a form (<a href="https://github.com/danielo515/obsidian-modal-form/commit/47d4d8cc6bebb1bf638c4dccf24fe4cc73094c36">47d4d8c</a>)</li>
 </ul>
 <h2 id="1361-2024-01-06"><a href="https://github.com/danielo515/obsidian-modal-form/compare/1.36.0...1.36.1">1.36.1</a> (2024-01-06)</h2>
-<h3 id="bug-fixes_17">Bug Fixes</h3>
+<h3 id="bug-fixes_18">Bug Fixes</h3>
 <ul>
 <li><strong>form-runtime:</strong> show an asterisk when fields are required (<a href="https://github.com/danielo515/obsidian-modal-form/commit/b578ace00564c99f2dcbddee81047b98f4f097f9">b578ace</a>), closes <a href="https://github.com/danielo515/obsidian-modal-form/issues/198">#198</a></li>
 </ul>
 <h2 id="1360-2024-01-02"><a href="https://github.com/danielo515/obsidian-modal-form/compare/1.35.0...1.36.0">1.36.0</a> (2024-01-02)</h2>
-<h3 id="features_20">Features</h3>
+<h3 id="features_21">Features</h3>
 <ul>
 <li>allow any value in multi-select dataview (<a href="https://github.com/danielo515/obsidian-modal-form/commit/fa9da3d5197a13a14a9ed5be819f1f611736677b">fa9da3d</a>), closes <a href="https://github.com/danielo515/obsidian-modal-form/issues/54">#54</a></li>
 <li>multi-select fixed can allow unknown values (<a href="https://github.com/danielo515/obsidian-modal-form/commit/dcefe7c44c2ea97726c1e779ba47a2c511b54feb">dcefe7c</a>)</li>
 <li>tags input allow any value to be selected, even if it does not exist yet (<a href="https://github.com/danielo515/obsidian-modal-form/commit/1834bf5f6cdb4833d8a332abeda721deabfd5bf6">1834bf5</a>)</li>
 </ul>
 <h2 id="1350-2024-01-01"><a href="https://github.com/danielo515/obsidian-modal-form/compare/1.34.0...1.35.0">1.35.0</a> (2024-01-01)</h2>
-<h3 id="features_21">Features</h3>
+<h3 id="features_22">Features</h3>
 <ul>
 <li>option to have a global shortcut to modal form (<a href="https://github.com/danielo515/obsidian-modal-form/commit/d262a0e2bb6a5173611226fe284afeb090ce8695">d262a0e</a>)</li>
 </ul>
 <h2 id="1340-2023-12-29"><a href="https://github.com/danielo515/obsidian-modal-form/compare/1.33.0...1.34.0">1.34.0</a> (2023-12-29)</h2>
-<h3 id="features_22">Features</h3>
+<h3 id="features_23">Features</h3>
 <ul>
 <li>dataview query preview in FormBuilder (<a href="https://github.com/danielo515/obsidian-modal-form/commit/0a5b4cd69ec740a25b3d61a85325fb6297c9ed45">0a5b4cd</a>)</li>
 <li>real time query preview with errors (<a href="https://github.com/danielo515/obsidian-modal-form/commit/41a7dec8d9abccb761d48f878c38e55614002b3a">41a7dec</a>)</li>
 </ul>
 <h2 id="1330-2023-12-28"><a href="https://github.com/danielo515/obsidian-modal-form/compare/1.32.1...1.33.0">1.33.0</a> (2023-12-28)</h2>
-<h3 id="features_23">Features</h3>
+<h3 id="features_24">Features</h3>
 <ul>
 <li>dataview rendering method for FormValue (<a href="https://github.com/danielo515/obsidian-modal-form/commit/86839ce89f31def1dac365e175dc30b38d0dcaeb">86839ce</a>)</li>
 <li>FormResult is now a proxy, so you can access the contained result values safely and directly (<a href="https://github.com/danielo515/obsidian-modal-form/commit/3f4a6113d7d2a1dcaf19cea85546cb8046ff0d27">3f4a611</a>)</li>
@@ -5450,42 +5526,42 @@ <h3 id="features_23">Features</h3>
 <li>shortcut methods for the ResultValue helper (<a href="https://github.com/danielo515/obsidian-modal-form/commit/00ba405744cdb91d31d091f05018244e125bbdb4">00ba405</a>)</li>
 </ul>
 <h2 id="1321-2023-12-22"><a href="https://github.com/danielo515/obsidian-modal-form/compare/1.32.0...1.32.1">1.32.1</a> (2023-12-22)</h2>
-<h3 id="bug-fixes_18">Bug Fixes</h3>
+<h3 id="bug-fixes_19">Bug Fixes</h3>
 <ul>
 <li>inline help for dataview (<a href="https://github.com/danielo515/obsidian-modal-form/commit/d7e06304aca1c0b9b9a9a7b5540d58289493266b">d7e0630</a>)</li>
 </ul>
 <h2 id="1320-2023-12-17"><a href="https://github.com/danielo515/obsidian-modal-form/compare/1.31.0...1.32.0">1.32.0</a> (2023-12-17)</h2>
-<h3 id="features_24">Features</h3>
+<h3 id="features_25">Features</h3>
 <ul>
 <li><strong>template:</strong> add support for frontmatter command in templates (<a href="https://github.com/danielo515/obsidian-modal-form/commit/059891c6ca80040a0e5a47c6d04cdb3bb8a7e220">059891c</a>)</li>
 </ul>
 <h2 id="1310-2023-12-17"><a href="https://github.com/danielo515/obsidian-modal-form/compare/1.30.1...1.31.0">1.31.0</a> (2023-12-17)</h2>
-<h3 id="features_25">Features</h3>
+<h3 id="features_26">Features</h3>
 <ul>
 <li>added a get method for result data fixes <a href="https://github.com/danielo515/obsidian-modal-form/issues/129">#129</a> (<a href="https://github.com/danielo515/obsidian-modal-form/commit/ddee8a84b255f2193a9267786a80611382bdd046">ddee8a8</a>)</li>
 </ul>
-<h3 id="bug-fixes_19">Bug Fixes</h3>
+<h3 id="bug-fixes_20">Bug Fixes</h3>
 <ul>
 <li>add aliases for Result methods fixes <a href="https://github.com/danielo515/obsidian-modal-form/issues/122">#122</a> (<a href="https://github.com/danielo515/obsidian-modal-form/commit/d6f755cea44195b3bfb77d1996ededc8356334bc">d6f755c</a>)</li>
 </ul>
 <h2 id="1301-2023-12-16"><a href="https://github.com/danielo515/obsidian-modal-form/compare/1.30.0...1.30.1">1.30.1</a> (2023-12-16)</h2>
-<h3 id="bug-fixes_20">Bug Fixes</h3>
+<h3 id="bug-fixes_21">Bug Fixes</h3>
 <ul>
 <li>creation of unique note name (<a href="https://github.com/danielo515/obsidian-modal-form/commit/b40b2c355311a3bcb67ddf1c94ce15636cb74b95">b40b2c3</a>)</li>
 <li>prevent chalk to be loaded in bundle (<a href="https://github.com/danielo515/obsidian-modal-form/commit/37e450895d30863b7f1aac33c071f1f5abd55cc9">37e4508</a>)</li>
 </ul>
 <h2 id="1300-2023-12-15"><a href="https://github.com/danielo515/obsidian-modal-form/compare/1.29.0...1.30.0">1.30.0</a> (2023-12-15)</h2>
-<h3 id="features_26">Features</h3>
+<h3 id="features_27">Features</h3>
 <ul>
 <li>create new notes from forms using templates (<a href="https://github.com/danielo515/obsidian-modal-form/commit/2a5d1bcc26c7577313806865fe1f77d5c4cd5dcb">2a5d1bc</a>)</li>
 </ul>
 <h2 id="1290-2023-12-08"><a href="https://github.com/danielo515/obsidian-modal-form/compare/1.28.0...1.29.0">1.29.0</a> (2023-12-08)</h2>
-<h3 id="features_27">Features</h3>
+<h3 id="features_28">Features</h3>
 <ul>
 <li><strong>input:</strong> new input folder suggester (<a href="https://github.com/danielo515/obsidian-modal-form/commit/2102619376c5e3483815f73bfbd5a78a2f3ed65b">2102619</a>), closes <a href="https://github.com/danielo515/obsidian-modal-form/issues/148">#148</a></li>
 </ul>
 <h2 id="1280-2023-12-07"><a href="https://github.com/danielo515/obsidian-modal-form/compare/1.27.1...1.28.0">1.28.0</a> (2023-12-07)</h2>
-<h3 id="features_28">Features</h3>
+<h3 id="features_29">Features</h3>
 <ul>
 <li><strong>API:</strong> example form takes options (<a href="https://github.com/danielo515/obsidian-modal-form/commit/d204786fb088924c6fbecb7ec8f2ffefc365267c">d204786</a>)</li>
 <li><strong>core:</strong> throttle error messages (<a href="https://github.com/danielo515/obsidian-modal-form/commit/60157bd1a8b63eeaa8fdf7d02fc31d7fe6936af7">60157bd</a>)</li>
@@ -5494,7 +5570,7 @@ <h3 id="features_28">Features</h3>
 <li><strong>form-runtime:</strong> the form is now reactive (<a href="https://github.com/danielo515/obsidian-modal-form/commit/ad827897712376c1640ccd7cd0e4648c3d1b6f5c">ad82789</a>)</li>
 <li><strong>validation:</strong> better UI for notify errors of form (<a href="https://github.com/danielo515/obsidian-modal-form/commit/2a609ae2b434e9db13b0d3f6909cae98fab380a4">2a609ae</a>)</li>
 </ul>
-<h3 id="bug-fixes_21">Bug Fixes</h3>
+<h3 id="bug-fixes_22">Bug Fixes</h3>
 <ul>
 <li>add a link to the docs in the settings (<a href="https://github.com/danielo515/obsidian-modal-form/commit/704aa99805c1dd36f7e5f16df8d12ec94e3a1022">704aa99</a>), closes <a href="https://github.com/danielo515/obsidian-modal-form/issues/58">#58</a></li>
 <li>functional form engine (<a href="https://github.com/danielo515/obsidian-modal-form/commit/ab99b0e1c211ad94683b6bafd19bf58edc946c74">ab99b0e</a>)</li>
@@ -5502,85 +5578,85 @@ <h3 id="bug-fixes_21">Bug Fixes</h3>
 <li>preettier invalid form view in form manager (<a href="https://github.com/danielo515/obsidian-modal-form/commit/b256a1a9d831f935f7c3ea1b191eae49cd567416">b256a1a</a>)</li>
 </ul>
 <h2 id="1271-2023-11-23"><a href="https://github.com/danielo515/obsidian-modal-form/compare/1.27.0...1.27.1">1.27.1</a> (2023-11-23)</h2>
-<h3 id="bug-fixes_22">Bug Fixes</h3>
+<h3 id="bug-fixes_23">Bug Fixes</h3>
 <ul>
 <li>remove leading # in tags (<a href="https://github.com/danielo515/obsidian-modal-form/commit/556b7699d544ec67f286e01f41104075f7b2f6a8">556b769</a>)</li>
 </ul>
 <h2 id="1270-2023-11-22"><a href="https://github.com/danielo515/obsidian-modal-form/compare/1.26.0...1.27.0">1.27.0</a> (2023-11-22)</h2>
-<h3 id="features_29">Features</h3>
+<h3 id="features_30">Features</h3>
 <ul>
 <li><strong>input:</strong> tag suggest input, initial version (<a href="https://github.com/danielo515/obsidian-modal-form/commit/9f0d8af170448a2d5593ae47b786316bf7b7a23d">9f0d8af</a>), closes <a href="https://github.com/danielo515/obsidian-modal-form/issues/118">#118</a></li>
 </ul>
 <h2 id="1260-2023-11-07"><a href="https://github.com/danielo515/obsidian-modal-form/compare/1.25.0...1.26.0">1.26.0</a> (2023-11-07)</h2>
-<h3 id="features_30">Features</h3>
+<h3 id="features_31">Features</h3>
 <ul>
 <li>ability to add a custom class name to the form body (<a href="https://github.com/danielo515/obsidian-modal-form/commit/28d81b950b3cb91fc85fffad596aa34d78ccd755">28d81b9</a>), closes <a href="https://github.com/danielo515/obsidian-modal-form/issues/125">#125</a></li>
 </ul>
 <h2 id="1250-2023-11-06"><a href="https://github.com/danielo515/obsidian-modal-form/compare/1.24.1...1.25.0">1.25.0</a> (2023-11-06)</h2>
-<h3 id="features_31">Features</h3>
+<h3 id="features_32">Features</h3>
 <ul>
 <li>make the dataview input more fuzzy (<a href="https://github.com/danielo515/obsidian-modal-form/commit/1971fdc096efce969d2f139b8c67279188418326">1971fdc</a>)</li>
 </ul>
 <h2 id="1241-2023-11-04"><a href="https://github.com/danielo515/obsidian-modal-form/compare/1.24.0...1.24.1">1.24.1</a> (2023-11-04)</h2>
-<h3 id="bug-fixes_23">Bug Fixes</h3>
+<h3 id="bug-fixes_24">Bug Fixes</h3>
 <ul>
 <li><strong>input:</strong> if folder does not exist, the form does not fail (<a href="https://github.com/danielo515/obsidian-modal-form/commit/0d5afbd399a6635c77534c3fb0e9b2838ee22040">0d5afbd</a>), closes <a href="https://github.com/danielo515/obsidian-modal-form/issues/90">#90</a></li>
 </ul>
 <h2 id="1240-2023-11-03"><a href="https://github.com/danielo515/obsidian-modal-form/compare/1.23.0...1.24.0">1.24.0</a> (2023-11-03)</h2>
-<h3 id="features_32">Features</h3>
+<h3 id="features_33">Features</h3>
 <ul>
 <li><strong>editor:</strong> create dataview inputs (<a href="https://github.com/danielo515/obsidian-modal-form/commit/75f71f1438afeab75dbeef179e41521244896797">75f71f1</a>)</li>
 <li><strong>inputs:</strong> dataview can be used as source for multi-select (<a href="https://github.com/danielo515/obsidian-modal-form/commit/cd39785d68fb78444db1d230f55c71907d218b6a">cd39785</a>), closes <a href="https://github.com/danielo515/obsidian-modal-form/issues/50">#50</a></li>
 </ul>
 <h2 id="1230-2023-11-02"><a href="https://github.com/danielo515/obsidian-modal-form/compare/1.22.1...1.23.0">1.23.0</a> (2023-11-02)</h2>
-<h3 id="features_33">Features</h3>
+<h3 id="features_34">Features</h3>
 <ul>
 <li>specific field/input error reporting methods (<a href="https://github.com/danielo515/obsidian-modal-form/commit/3bfd22d7c2da0511ee2fc82859de0a9e2b37f045">3bfd22d</a>)</li>
 </ul>
-<h3 id="bug-fixes_24">Bug Fixes</h3>
+<h3 id="bug-fixes_25">Bug Fixes</h3>
 <ul>
 <li>forms can not be renamed (<a href="https://github.com/danielo515/obsidian-modal-form/commit/ab2e20d5a6f8b76d3ed4685c2a4fddcb9c3ce261">ab2e20d</a>), closes <a href="https://github.com/danielo515/obsidian-modal-form/issues/108">#108</a></li>
 <li>ManageForms view is now reactive thanks to stores (<a href="https://github.com/danielo515/obsidian-modal-form/commit/040f8f504c282876b7798da00db3ddda9f8a1c9f">040f8f5</a>)</li>
 </ul>
 <h2 id="1221-2023-10-26"><a href="https://github.com/danielo515/obsidian-modal-form/compare/1.22.0...1.22.1">1.22.1</a> (2023-10-26)</h2>
-<h3 id="bug-fixes_25">Bug Fixes</h3>
+<h3 id="bug-fixes_26">Bug Fixes</h3>
 <ul>
 <li>big bundle size (<a href="https://github.com/danielo515/obsidian-modal-form/commit/e5f566ea8411be7fa7c06efaddca125b7799ec34">e5f566e</a>)</li>
 </ul>
 <h2 id="1220-2023-10-26"><a href="https://github.com/danielo515/obsidian-modal-form/compare/1.21.0...1.22.0">1.22.0</a> (2023-10-26)</h2>
-<h3 id="features_34">Features</h3>
+<h3 id="features_35">Features</h3>
 <ul>
 <li>allow pick/omit in Result helpers (<a href="https://github.com/danielo515/obsidian-modal-form/commit/1c5bd5f09a2525ffcdb9226834730b044a3aee6c">1c5bd5f</a>), closes <a href="https://github.com/danielo515/obsidian-modal-form/issues/101">#101</a></li>
 </ul>
-<h3 id="bug-fixes_26">Bug Fixes</h3>
+<h3 id="bug-fixes_27">Bug Fixes</h3>
 <ul>
 <li>add tests for result class and helpers (<a href="https://github.com/danielo515/obsidian-modal-form/commit/e4eea189d168fb80000ca722630334c018f6fd04">e4eea18</a>)</li>
 <li>dataview list format is now correct (<a href="https://github.com/danielo515/obsidian-modal-form/commit/e4eea189d168fb80000ca722630334c018f6fd04">e4eea18</a>)</li>
 </ul>
 <h2 id="1210-2023-10-25"><a href="https://github.com/danielo515/obsidian-modal-form/compare/1.20.0...1.21.0">1.21.0</a> (2023-10-25)</h2>
-<h3 id="features_35">Features</h3>
+<h3 id="features_36">Features</h3>
 <ul>
 <li>detect invalid data on data.json (<a href="https://github.com/danielo515/obsidian-modal-form/commit/91aa99c1c899f2831999318d377b7dee01b642a7">91aa99c</a>), closes <a href="https://github.com/danielo515/obsidian-modal-form/issues/98">#98</a></li>
 <li>migrate between form format versions (<a href="https://github.com/danielo515/obsidian-modal-form/commit/b4e6c963ad7359ca094b5fc92658e50976bbd18a">b4e6c96</a>), closes <a href="https://github.com/danielo515/obsidian-modal-form/issues/92">#92</a></li>
 </ul>
-<h3 id="bug-fixes_27">Bug Fixes</h3>
+<h3 id="bug-fixes_28">Bug Fixes</h3>
 <ul>
 <li>add version to the form definition (<a href="https://github.com/danielo515/obsidian-modal-form/commit/c7fdd777f9f1fbce4402a58000ecea1a84d0af52">c7fdd77</a>)</li>
 <li>proper duplicate scroll (<a href="https://github.com/danielo515/obsidian-modal-form/commit/28cebd42d0b50d968b4fa2678425d4a378f9dd00">28cebd4</a>)</li>
 </ul>
 <h2 id="1200-2023-10-22"><a href="https://github.com/danielo515/obsidian-modal-form/compare/1.19.0...1.20.0">1.20.0</a> (2023-10-22)</h2>
-<h3 id="features_36">Features</h3>
+<h3 id="features_37">Features</h3>
 <ul>
 <li>Enable Ctrl+Enter form submission (<a href="https://github.com/danielo515/obsidian-modal-form/issues/60">#60</a>) (<a href="https://github.com/danielo515/obsidian-modal-form/commit/7f721222733e93f0c6d600bf55c0a203135e20df">7f72122</a>)</li>
 </ul>
 <h2 id="1190-2023-10-22"><a href="https://github.com/danielo515/obsidian-modal-form/compare/1.18.0...1.19.0">1.19.0</a> (2023-10-22)</h2>
-<h3 id="features_37">Features</h3>
+<h3 id="features_38">Features</h3>
 <ul>
 <li>Export form as JSON button (<a href="https://github.com/danielo515/obsidian-modal-form/issues/29">#29</a>) (<a href="https://github.com/danielo515/obsidian-modal-form/commit/defc86c654b80ebb071e1eaa8b715f962e41c044">defc86c</a>)</li>
 <li>scroll to elements on the list (<a href="https://github.com/danielo515/obsidian-modal-form/commit/f9804a7dde5ba46b045f4f4ad41eacb4b6e3fd22">f9804a7</a>)</li>
 <li>scroll to new fields in the editor (<a href="https://github.com/danielo515/obsidian-modal-form/commit/ce3ece5da6fc42b295eee06d7295891ce20622ba">ce3ece5</a>)</li>
 </ul>
-<h3 id="bug-fixes_28">Bug Fixes</h3>
+<h3 id="bug-fixes_29">Bug Fixes</h3>
 <ul>
 <li>accept empty option values for now (<a href="https://github.com/danielo515/obsidian-modal-form/commit/6293dade57e451bc68162d5a07db2664fecbfd1f">6293dad</a>)</li>
 <li>ensure types in svelte at build (<a href="https://github.com/danielo515/obsidian-modal-form/commit/fbe03d36bdf70551c73c3ce12150e6cdae2264b9">fbe03d3</a>)</li>
@@ -5589,181 +5665,181 @@ <h3 id="bug-fixes_28">Bug Fixes</h3>
 <li>type narrow on svelte (<a href="https://github.com/danielo515/obsidian-modal-form/commit/c46dc400dee5bc2df704d0c95a5577a298f517a8">c46dc40</a>)</li>
 </ul>
 <h2 id="1180-2023-10-21"><a href="https://github.com/danielo515/obsidian-modal-form/compare/1.17.0...1.18.0">1.18.0</a> (2023-10-21)</h2>
-<h3 id="features_38">Features</h3>
+<h3 id="features_39">Features</h3>
 <ul>
 <li>ability to order select options (<a href="https://github.com/danielo515/obsidian-modal-form/issues/64">#64</a>) (<a href="https://github.com/danielo515/obsidian-modal-form/commit/b955726bf3d44ea258ed2656ae746af3ab5e710b">b955726</a>)</li>
 </ul>
 <h2 id="1170-2023-10-20"><a href="https://github.com/danielo515/obsidian-modal-form/compare/1.16.6...1.17.0">1.17.0</a> (2023-10-20)</h2>
-<h3 id="features_39">Features</h3>
+<h3 id="features_40">Features</h3>
 <ul>
 <li>added tests (<a href="https://github.com/danielo515/obsidian-modal-form/commit/1230a3477209141870856a2b7804bec5cc92c9c0">1230a34</a>)</li>
 <li>show errors when form has any invalid field (<a href="https://github.com/danielo515/obsidian-modal-form/commit/54e9eaf4a0827958fc7f7e312b928d793e026963">54e9eaf</a>)</li>
 </ul>
 <h2 id="1166-2023-10-19"><a href="https://github.com/danielo515/obsidian-modal-form/compare/1.16.5...1.16.6">1.16.6</a> (2023-10-19)</h2>
-<h3 id="bug-fixes_29">Bug Fixes</h3>
+<h3 id="bug-fixes_30">Bug Fixes</h3>
 <ul>
 <li>remove all trace of text input suggest (<a href="https://github.com/danielo515/obsidian-modal-form/commit/68cace2135ac38d66027d1f620f34eda700e82df">68cace2</a>)</li>
 </ul>
 <h2 id="1165-2023-10-19"><a href="https://github.com/danielo515/obsidian-modal-form/compare/1.16.4...1.16.5">1.16.5</a> (2023-10-19)</h2>
-<h3 id="bug-fixes_30">Bug Fixes</h3>
+<h3 id="bug-fixes_31">Bug Fixes</h3>
 <ul>
 <li>separate input builder for select (<a href="https://github.com/danielo515/obsidian-modal-form/commit/e75a1f43f7e7e674806ae9771d9c9155a8a0e7cc">e75a1f4</a>), closes <a href="https://github.com/danielo515/obsidian-modal-form/issues/75">#75</a></li>
 </ul>
 <h2 id="1164-2023-10-16"><a href="https://github.com/danielo515/obsidian-modal-form/compare/1.16.3...1.16.4">1.16.4</a> (2023-10-16)</h2>
-<h3 id="bug-fixes_31">Bug Fixes</h3>
+<h3 id="bug-fixes_32">Bug Fixes</h3>
 <ul>
 <li>do not close existing leafs, reuse instead (<a href="https://github.com/danielo515/obsidian-modal-form/commit/b00b6b8d407371450bf4ab0f88cf1fd68f36855f">b00b6b8</a>), closes <a href="https://github.com/danielo515/obsidian-modal-form/issues/36">#36</a></li>
 <li>open the main view in a new tab (<a href="https://github.com/danielo515/obsidian-modal-form/commit/b00b6b8d407371450bf4ab0f88cf1fd68f36855f">b00b6b8</a>)</li>
 </ul>
 <h2 id="1163-2023-10-16"><a href="https://github.com/danielo515/obsidian-modal-form/compare/1.16.2...1.16.3">1.16.3</a> (2023-10-16)</h2>
-<h3 id="bug-fixes_32">Bug Fixes</h3>
+<h3 id="bug-fixes_33">Bug Fixes</h3>
 <ul>
 <li>text-area initial value (<a href="https://github.com/danielo515/obsidian-modal-form/commit/f21b783cfefc9485a8f7748539076bb7d0def2b8">f21b783</a>)</li>
 </ul>
 <h2 id="1162-2023-10-11"><a href="https://github.com/danielo515/obsidian-modal-form/compare/1.16.1...1.16.2">1.16.2</a> (2023-10-11)</h2>
-<h3 id="bug-fixes_33">Bug Fixes</h3>
+<h3 id="bug-fixes_34">Bug Fixes</h3>
 <ul>
 <li>make multi-select static work (<a href="https://github.com/danielo515/obsidian-modal-form/commit/fa5987a93ae7ef7bc6aea60f6273bbcb6e78fcc1">fa5987a</a>), closes <a href="https://github.com/danielo515/obsidian-modal-form/issues/63">#63</a></li>
 </ul>
 <h2 id="1161-2023-10-10"><a href="https://github.com/danielo515/obsidian-modal-form/compare/1.16.0...1.16.1">1.16.1</a> (2023-10-10)</h2>
-<h3 id="bug-fixes_34">Bug Fixes</h3>
+<h3 id="bug-fixes_35">Bug Fixes</h3>
 <ul>
 <li>ensure order of fixed select (<a href="https://github.com/danielo515/obsidian-modal-form/commit/62b407ea50b39c873d3f83e86ff9e502a88a6d22">62b407e</a>), closes <a href="https://github.com/danielo515/obsidian-modal-form/issues/61">#61</a></li>
 </ul>
 <h2 id="1160-2023-10-03"><a href="https://github.com/danielo515/obsidian-modal-form/compare/1.15.0...1.16.0">1.16.0</a> (2023-10-03)</h2>
-<h3 id="features_40">Features</h3>
+<h3 id="features_41">Features</h3>
 <ul>
 <li>add multi-line text area (<a href="https://github.com/danielo515/obsidian-modal-form/commit/1cf155951b1c38af59abb84cf16e6c852bd87abd">1cf1559</a>), closes <a href="https://github.com/danielo515/obsidian-modal-form/issues/46">#46</a></li>
 </ul>
 <h2 id="1150-2023-10-02"><a href="https://github.com/danielo515/obsidian-modal-form/compare/1.14.1...1.15.0">1.15.0</a> (2023-10-02)</h2>
-<h3 id="features_41">Features</h3>
+<h3 id="features_42">Features</h3>
 <ul>
 <li>default values support for most input types (<a href="https://github.com/danielo515/obsidian-modal-form/commit/f8415a32554f1add8b50e667a7ca9664232ee2e1">f8415a3</a>)</li>
 </ul>
-<h3 id="bug-fixes_35">Bug Fixes</h3>
+<h3 id="bug-fixes_36">Bug Fixes</h3>
 <ul>
 <li>do not use innerHTML (<a href="https://github.com/danielo515/obsidian-modal-form/commit/8ae7d5be014840ddb8e19619097af7ad1d9bccc2">8ae7d5b</a>)</li>
 </ul>
 <h2 id="1141-2023-09-29"><a href="https://github.com/danielo515/obsidian-modal-form/compare/1.14.0...1.14.1">1.14.1</a> (2023-09-29)</h2>
-<h3 id="bug-fixes_36">Bug Fixes</h3>
+<h3 id="bug-fixes_37">Bug Fixes</h3>
 <ul>
 <li>properly clone elements (<a href="https://github.com/danielo515/obsidian-modal-form/commit/667ebe0d94526803dbad6d62069c36757355dbe5">667ebe0</a>), closes <a href="https://github.com/danielo515/obsidian-modal-form/issues/51">#51</a></li>
 <li>set a default value for inputs of type select (<a href="https://github.com/danielo515/obsidian-modal-form/commit/2c514b1095edf37e37151ca89f2ea10b440db446">2c514b1</a>), closes <a href="https://github.com/danielo515/obsidian-modal-form/issues/45">#45</a></li>
 </ul>
 <h2 id="1140-2023-09-15"><a href="https://github.com/danielo515/obsidian-modal-form/compare/1.13.0...1.14.0">1.14.0</a> (2023-09-15)</h2>
-<h3 id="features_42">Features</h3>
+<h3 id="features_43">Features</h3>
 <ul>
 <li>show result preview (<a href="https://github.com/danielo515/obsidian-modal-form/commit/7425df13425c5e957dc9a9f1cc2a8f2bcb1d1c5f">7425df1</a>)</li>
 </ul>
-<h3 id="bug-fixes_37">Bug Fixes</h3>
+<h3 id="bug-fixes_38">Bug Fixes</h3>
 <ul>
 <li>filtering in multi with uppercase (<a href="https://github.com/danielo515/obsidian-modal-form/commit/fac67ea1199b2db9d27e4df0010e959e939927ab">fac67ea</a>)</li>
 <li>multi select was not including the values (<a href="https://github.com/danielo515/obsidian-modal-form/commit/1885834ded85f09deac185e2a3b2d91502585504">1885834</a>)</li>
 </ul>
 <h2 id="1130-2023-09-15"><a href="https://github.com/danielo515/obsidian-modal-form/compare/1.12.1...1.13.0">1.13.0</a> (2023-09-15)</h2>
-<h3 id="features_43">Features</h3>
+<h3 id="features_44">Features</h3>
 <ul>
 <li>limitedForm api (<a href="https://github.com/danielo515/obsidian-modal-form/commit/b0acb29e85dc806bbf3ff04391c42c220bfcb178">b0acb29</a>), closes <a href="https://github.com/danielo515/obsidian-modal-form/issues/39">#39</a></li>
 </ul>
 <h2 id="1121-2023-09-15"><a href="https://github.com/danielo515/obsidian-modal-form/compare/1.12.0...1.12.1">1.12.1</a> (2023-09-15)</h2>
-<h3 id="bug-fixes_38">Bug Fixes</h3>
+<h3 id="bug-fixes_39">Bug Fixes</h3>
 <ul>
 <li>make sure the editor always has the right height (<a href="https://github.com/danielo515/obsidian-modal-form/commit/53f10b3a2451efd347855e486f46aa64eaaeeec3">53f10b3</a>), closes <a href="https://github.com/danielo515/obsidian-modal-form/issues/38">#38</a></li>
 </ul>
 <h2 id="1120-2023-09-15"><a href="https://github.com/danielo515/obsidian-modal-form/compare/1.11.0...1.12.0">1.12.0</a> (2023-09-15)</h2>
-<h3 id="features_44">Features</h3>
+<h3 id="features_45">Features</h3>
 <ul>
 <li>multi select UI builder (<a href="https://github.com/danielo515/obsidian-modal-form/commit/3eff7a89c7177faa47940c16d04f97f5d72a3a21">3eff7a8</a>)</li>
 <li>multi-select v1 (<a href="https://github.com/danielo515/obsidian-modal-form/commit/e3ee49281f39ed6708cdd48f8bba527e74d5584b">e3ee492</a>)</li>
 </ul>
-<h3 id="bug-fixes_39">Bug Fixes</h3>
+<h3 id="bug-fixes_40">Bug Fixes</h3>
 <ul>
 <li>proper colors for save and close (<a href="https://github.com/danielo515/obsidian-modal-form/commit/4c6d495a8b0e550b9f117e5d340885a8052f55c9">4c6d495</a>)</li>
 <li>toggles always have a value (<a href="https://github.com/danielo515/obsidian-modal-form/commit/72cfc3e65624a31d4a200301465aa9044e908357">72cfc3e</a>)</li>
 </ul>
 <h2 id="1110-2023-09-14"><a href="https://github.com/danielo515/obsidian-modal-form/compare/1.10.0...1.11.0">1.11.0</a> (2023-09-14)</h2>
-<h3 id="features_45">Features</h3>
+<h3 id="features_46">Features</h3>
 <ul>
 <li>preview form from the editor (<a href="https://github.com/danielo515/obsidian-modal-form/commit/2d8e2d6aec99f27a30e86ffc49312a2876e5195e">2d8e2d6</a>), closes <a href="https://github.com/danielo515/obsidian-modal-form/issues/17">#17</a></li>
 </ul>
 <h2 id="1100-2023-09-14"><a href="https://github.com/danielo515/obsidian-modal-form/compare/1.9.1...1.10.0">1.10.0</a> (2023-09-14)</h2>
-<h3 id="features_46">Features</h3>
+<h3 id="features_47">Features</h3>
 <ul>
 <li>show better errors (<a href="https://github.com/danielo515/obsidian-modal-form/commit/8202d378cac76f6a3f49058c78e9988daa5432e6">8202d37</a>)</li>
 </ul>
-<h3 id="bug-fixes_40">Bug Fixes</h3>
+<h3 id="bug-fixes_41">Bug Fixes</h3>
 <ul>
 <li>dataview input was not filtering (<a href="https://github.com/danielo515/obsidian-modal-form/commit/8202d378cac76f6a3f49058c78e9988daa5432e6">8202d37</a>)</li>
 </ul>
 <h2 id="191-2023-09-14"><a href="https://github.com/danielo515/obsidian-modal-form/compare/1.9.0...1.9.1">1.9.1</a> (2023-09-14)</h2>
-<h3 id="bug-fixes_41">Bug Fixes</h3>
+<h3 id="bug-fixes_42">Bug Fixes</h3>
 <ul>
 <li>release process (<a href="https://github.com/danielo515/obsidian-modal-form/commit/790d84d83200243b01ca6080575e3aabda663ff5">790d84d</a>)</li>
 </ul>
 <h2 id="190-2023-09-14"><a href="https://github.com/danielo515/obsidian-modal-form/compare/obsidian-modal-form-1.8.0...obsidian-modal-form-1.9.0">1.9.0</a> (2023-09-14)</h2>
-<h3 id="features_47">Features</h3>
+<h3 id="features_48">Features</h3>
 <ul>
 <li>keep the form header always visible (<a href="https://github.com/danielo515/obsidian-modal-form/commit/216d9b40a9ebfcc4ca208a5d0ba326cd73c755d5">216d9b4</a>), closes <a href="https://github.com/danielo515/obsidian-modal-form/issues/11">#11</a></li>
 </ul>
-<h3 id="bug-fixes_42">Bug Fixes</h3>
+<h3 id="bug-fixes_43">Bug Fixes</h3>
 <ul>
 <li>release-bot (<a href="https://github.com/danielo515/obsidian-modal-form/commit/0586068e6b69a3659fd27377510b0de3eeba6387">0586068</a>)</li>
 </ul>
 <h2 id="180-2023-09-13"><a href="https://github.com/danielo515/obsidian-modal-form/compare/obsidian-modal-form-1.7.1...obsidian-modal-form-1.8.0">1.8.0</a> (2023-09-13)</h2>
-<h3 id="features_48">Features</h3>
+<h3 id="features_49">Features</h3>
 <ul>
 <li>dataview input type (<a href="https://github.com/danielo515/obsidian-modal-form/commit/22b8949bbde2deeb417c89921ec4531b03af4ed2">22b8949</a>)</li>
 </ul>
 <h2 id="171-2023-09-13"><a href="https://github.com/danielo515/obsidian-modal-form/compare/obsidian-modal-form-1.7.0...obsidian-modal-form-1.7.1">1.7.1</a> (2023-09-13)</h2>
-<h3 id="bug-fixes_43">Bug Fixes</h3>
+<h3 id="bug-fixes_44">Bug Fixes</h3>
 <ul>
 <li>remove deprecated usages of app (<a href="https://github.com/danielo515/obsidian-modal-form/commit/343ff573ae7ed4710b3f3290bf752dee84e7aaae">343ff57</a>)</li>
 </ul>
 <h2 id="170-2023-09-12"><a href="https://github.com/danielo515/obsidian-modal-form/compare/obsidian-modal-form-v1.6.0...obsidian-modal-form-1.7.0">1.7.0</a> (2023-09-12)</h2>
-<h3 id="features_49">Features</h3>
+<h3 id="features_50">Features</h3>
 <ul>
 <li>duplicate form (<a href="https://github.com/danielo515/obsidian-modal-form/commit/7a0f1c6000d309c447fc4cb7e345dbf0f435944e">7a0f1c6</a>), closes <a href="https://github.com/danielo515/obsidian-modal-form/issues/20">#20</a></li>
 </ul>
-<h3 id="bug-fixes_44">Bug Fixes</h3>
+<h3 id="bug-fixes_45">Bug Fixes</h3>
 <ul>
 <li>fix the versioning, I hope (<a href="https://github.com/danielo515/obsidian-modal-form/commit/7bb7d7da9b58c1a7055d3178b4528f346ea62edd">7bb7d7d</a>)</li>
 </ul>
 <h2 id="160-2023-09-12"><a href="https://github.com/danielo515/obsidian-modal-form/compare/1.5.0...1.6.0">1.6.0</a> (2023-09-12)</h2>
-<h3 id="features_50">Features</h3>
+<h3 id="features_51">Features</h3>
 <ul>
 <li>allow to duplicate fields (<a href="https://github.com/danielo515/obsidian-modal-form/commit/21777e98252c6f0d403ea6223a007eb5c8ba1866">21777e9</a>), closes <a href="https://github.com/danielo515/obsidian-modal-form/issues/20">#20</a></li>
 </ul>
 <h2 id="150-2023-09-12"><a href="https://github.com/danielo515/obsidian-modal-form/compare/1.4.0...1.5.0">1.5.0</a> (2023-09-12)</h2>
-<h3 id="features_51">Features</h3>
+<h3 id="features_52">Features</h3>
 <ul>
 <li>ability to cancel edits to a form (<a href="https://github.com/danielo515/obsidian-modal-form/commit/f90d7f0344b6af0beba6f004e33719948dc6a36f">f90d7f0</a>), closes <a href="https://github.com/danielo515/obsidian-modal-form/issues/8">#8</a></li>
 </ul>
 <h2 id="140-2023-09-11"><a href="https://github.com/danielo515/obsidian-modal-form/compare/1.3.0...1.4.0">1.4.0</a> (2023-09-11)</h2>
-<h3 id="features_52">Features</h3>
+<h3 id="features_53">Features</h3>
 <ul>
 <li>decide where to open the forms editor/manager (<a href="https://github.com/danielo515/obsidian-modal-form/commit/bd5a957b7664eefd5df188b6424c046cfd0efd73">bd5a957</a>)</li>
 </ul>
-<h3 id="bug-fixes_45">Bug Fixes</h3>
+<h3 id="bug-fixes_46">Bug Fixes</h3>
 <ul>
 <li>make field name required (<a href="https://github.com/danielo515/obsidian-modal-form/commit/2892503b0beb4588833ac46cd2a32ad567140d88">2892503</a>)</li>
 </ul>
 <h2 id="130-2023-09-11"><a href="https://github.com/danielo515/obsidian-modal-form/compare/1.2.2...1.3.0">1.3.0</a> (2023-09-11)</h2>
-<h3 id="features_53">Features</h3>
+<h3 id="features_54">Features</h3>
 <ul>
 <li>ability to order fields (<a href="https://github.com/danielo515/obsidian-modal-form/commit/79517c03a9bceab06e9239e99ca8a3e100273f1d">79517c0</a>)</li>
 </ul>
 <h2 id="122-2023-09-11"><a href="https://github.com/danielo515/obsidian-modal-form/compare/1.2.1...1.2.2">1.2.2</a> (2023-09-11)</h2>
-<h3 id="bug-fixes_46">Bug Fixes</h3>
+<h3 id="bug-fixes_47">Bug Fixes</h3>
 <ul>
 <li>rename the plugin to follow obsidian guidelines (<a href="https://github.com/danielo515/obsidian-modal-form/commit/24875901eb01321d8d92ed2efffc70e661907b20">2487590</a>)</li>
 </ul>
 <h2 id="121-2023-09-11"><a href="https://github.com/danielo515/obsidian-modal-form/compare/v1.2.0...1.2.1">1.2.1</a> (2023-09-11)</h2>
-<h3 id="bug-fixes_47">Bug Fixes</h3>
+<h3 id="bug-fixes_48">Bug Fixes</h3>
 <ul>
 <li>do not include v in tag (<a href="https://github.com/danielo515/obsidian-modal-form/commit/7a54a246aa6b7262dc63130deed49ac0387226a3">7a54a24</a>)</li>
 </ul>
 <h2 id="120-2023-09-11"><a href="https://github.com/danielo515/obsidian-modal-form/compare/v1.1.0...v1.2.0">1.2.0</a> (2023-09-11)</h2>
-<h3 id="features_54">Features</h3>
+<h3 id="features_55">Features</h3>
 <ul>
 <li>complete core decoding and validation (<a href="https://github.com/danielo515/obsidian-modal-form/commit/7fc538ca28d4b6b4114640f298a093d5639c4326">7fc538c</a>)</li>
 <li>FormEditor V1 (<a href="https://github.com/danielo515/obsidian-modal-form/commit/ce228efb38cb18985e61923b67f5f25fd5b74c4e">ce228ef</a>)</li>
@@ -5771,20 +5847,20 @@ <h3 id="features_54">Features</h3>
 <li>mobile handling of the form editor (<a href="https://github.com/danielo515/obsidian-modal-form/commit/1be84bd71ce04565ac08cec6a82b398b004447ff">1be84bd</a>)</li>
 <li>suggest folder input (<a href="https://github.com/danielo515/obsidian-modal-form/commit/3adaf0774858ef34a0e2b3eb26657ee45bd119cd">3adaf07</a>)</li>
 </ul>
-<h3 id="bug-fixes_48">Bug Fixes</h3>
+<h3 id="bug-fixes_49">Bug Fixes</h3>
 <ul>
 <li>delete forms (<a href="https://github.com/danielo515/obsidian-modal-form/commit/70c6a77629953f63243bc2b1e8a0504fb54c1f74">70c6a77</a>)</li>
 <li>icons (<a href="https://github.com/danielo515/obsidian-modal-form/commit/fca57dd872fd80c2f92cdbad2f67a5249a4be8dd">fca57dd</a>)</li>
 </ul>
 <h2 id="110-2023-09-07"><a href="https://github.com/danielo515/obsidian-modal-form/compare/v1.0.0...v1.1.0">1.1.0</a> (2023-09-07)</h2>
-<h3 id="features_55">Features</h3>
+<h3 id="features_56">Features</h3>
 <ul>
 <li>asString using template (<a href="https://github.com/danielo515/obsidian-modal-form/commit/504167364200554593722341d09ffd7ad97db552">5041673</a>)</li>
 <li>real API v1 (<a href="https://github.com/danielo515/obsidian-modal-form/commit/1a8da2f2aded99e80347609304a91a6d35a1ed11">1a8da2f</a>)</li>
 <li>slider (<a href="https://github.com/danielo515/obsidian-modal-form/commit/bb9c0b58d5d0afa54c92294b741dd06040aa4c09">bb9c0b5</a>)</li>
 </ul>
 <h2 id="100-2023-09-06">1.0.0 (2023-09-06)</h2>
-<h3 id="features_56">Features</h3>
+<h3 id="features_57">Features</h3>
 <ul>
 <li>add support for all the basic fields (<a href="https://github.com/danielo515/obsidian-modal-form/commit/991c53e881a473200c035ad7eec590378cdaf81a">991c53e</a>)</li>
 <li>dataview serialization (<a href="https://github.com/danielo515/obsidian-modal-form/commit/9b384021b06dfb4d1ab0625353367b724c4ac004">9b38402</a>)</li>
diff --git a/search/search_index.json b/search/search_index.json
index 18ad17c..170cc9e 100644
--- a/search/search_index.json
+++ b/search/search_index.json
@@ -1 +1 @@
-{"config":{"lang":["en"],"separator":"[\\s\\-]+","pipeline":["stopWordFilter"]},"docs":[{"location":"","title":"Home","text":""},{"location":"#obsidian-modal-form-plugin","title":"Obsidian Modal Form Plugin","text":"<p>This plugin for Obsidian allows you to define forms that can be opened from anywhere you can run JavaScript, so you can combine it with other plugins like Templater or QuickAdd.</p> <p>https://github.com/danielo515/obsidian-modal-form/assets/2270425/542974aa-c58b-4733-89ea-9c20ea11bee9</p>"},{"location":"#features","title":"Features","text":"<ul> <li>Forms open in a modal window and return you the values, so you can trigger it from:<ul> <li>Templater templates</li> <li>QuickAdd captures</li> <li>DataviewJS queries</li> <li>Many other places...</li> </ul> </li> <li>Define forms using a simple JSON format</li> <li>Create and manage a collection of forms, each identified by a unique name</li> <li>User interface for creating new forms</li> <li>Create new notes directly from the form using templates<ul> <li>Template editor has a nice UI for creating templates</li> </ul> </li> <li>Many input types<ul> <li>number</li> <li>date</li> <li>time</li> <li>slider</li> <li>toggle (true/false)</li> <li>free text</li> <li>text with autocompletion for note names (from a folder or root)</li> <li>text with autocompletion from a dataview query (requires dataview plugin)</li> <li>multiple choice input</li> <li>select from a list<ul> <li>list of fixed values</li> <li>list of notes from a folder</li> </ul> </li> </ul> </li> </ul>"},{"location":"#template-builder","title":"Template builder","text":"<p>We have a nice UI to help you creating the required templates. </p>"},{"location":"#why-this-plugin","title":"Why this plugin?","text":"<p>Obsidian is a great tool for taking notes, but it is also a nice for managing data. However, when it's time to capture structured data it doesn't offer many conveniences. Some plugins like Templater or QuickAdd alleviate this problem with templates/automation that ease the creation of notes with a predefined structure, but then you have to fill the data manually. The mentioned plugins (Templater, QuickAdd) have some little convenience inputs, but they have certain tradeoffs/problems:</p> <ul> <li>they are limited to inputting a single value at a time</li> <li>they don't have labels or detailed descriptions about the field you are filling</li> <li>you can't skip fields, you will always be prompted for all of them one by one</li> </ul> <p>All of the mentioned tools are great at their job and unleash super convenient workflows. For that reason, rather than offering an alternative, this plugin is designed as a complement to them, offering some basic building blocks that you can integrate with your existing templates and workflows.</p>"},{"location":"#friends-of-modal-form","title":"Friends of modal form","text":"<ul> <li>Templater to open modals from templates</li> <li>QuickAdd to quickly capture data from a modal</li> <li>dataview to provide values for auto-completion</li> </ul>"},{"location":"#scope-of-this-plugin","title":"Scope of this plugin","text":"<p>This plugin is intentionally narrow in scope. As mentioned in the previous section, it is designed as a building block, so you can integrate it with other plugins and workflows. The only features that I will consider adding will be ones about improving the form itself.</p>"},{"location":"#usage","title":"Usage","text":""},{"location":"#call-the-form-from-javascript","title":"Call the form from JavaScript","text":"<p>Since the main usage of this plugin is opening forms and getting back their data let's start with that. If you want to learn how to create forms, skip to the next section define a form.</p> <p>The plugin exposes an API that can be accessed from any JavaScript code that has access to the global <code>app</code> object. So, in order to get the API you can do:</p> <pre><code>const modalForm = app.plugins.plugins.modalforms.api;\n</code></pre> <p>From here you can call any of the main methods of the API, <code>openForm</code> which allows you to open a form by name and get back the data. Let's see an example:</p> <pre><code>const modalForm = app.plugins.plugins.modalforms.api;\nconst result = await modalForm.openForm(\"example-form\");\n</code></pre> <p>The result is a special type of object that contains the data of the form. It also has some convenient methods to help you process the returned data. One of them is <code>asFrontmatterString</code>, which returns the data as a string that can be used in a frontmatter block. Let's see an example using Templater:</p>"},{"location":"#usage-with-templater","title":"Usage with Templater","text":"<pre><code>---\n&lt;%*\nconst modalForm = app.plugins.plugins.modalforms.api;\nconst result = await modalForm.openForm('example-form');\ntR += result.asFrontmatterString();\n-%&gt;\n---\n</code></pre> <p>When you insert this template in a note, it will open the form, and once you submit it, it will insert the data in the note as a frontmatter block.</p>"},{"location":"#usage-with-quickadd","title":"Usage with QuickAdd","text":"<p>In order to open a form from QuickAdd capture, you need to create a capture and activate the capture format, then in the format text-area you must create a code block with the language defined as <code>js quickadd</code> and copy the code below:</p> <pre><code>```js quickadd\n    const modalForm = app.plugins.plugins.modalforms.api;\n    const result = await modalForm.openForm('example-form');\n    return result.asDataviewProperties();\n```\n</code></pre> <p>Here you have an example screenshot of how it should look like: </p>"},{"location":"#providing-default-values-when-opening-a-form","title":"Providing Default Values When Opening a Form","text":"<p>When opening a form you can provide default values for the form fields. This can be done by passing an object to the <code>openForm</code> or <code>limitedForm</code> methods as part of the <code>FormOptions</code> parameter. This object should have the same structure as the form definition, with each key corresponding to a field name and its value being the default value for that field.</p> <p>Here's an example:</p> <pre><code>const values = {\n    title: \"My Default Title\",\n    description: \"This is a default description.\",\n};\n\nconst modalForm = app.plugins.plugins.modalforms.api;\nconst result = await modalForm.openForm(\"example-form\", { values: values });\n</code></pre> <p>In this example, the form will open with the <code>title</code> field pre-filled with <code>My Default Title</code> and the <code>description</code> field pre-filled with <code>This is a default description.</code>.</p> <p>Note: If a field in the default values object does not exist in the form definition, it will be ignored.</p>"},{"location":"#formresult-methods","title":"FormResult Methods","text":"<p>When you open a form, you get back a <code>FormResult</code> object. This object contains the data of the form and some methods to help you process it. This <code>FormResult</code> object returned by the <code>openForm</code> method has several methods that can be used to process the form data. Here is a brief description of each method:</p>"},{"location":"#asfrontmatterstring","title":"asFrontmatterString()","text":"<p>This method returns the form data as a string that can be used in a frontmatter block. It formats the data in YAML syntax. Here is an example of how to use it:</p>"},{"location":"#asdataviewproperties","title":"asDataviewProperties()","text":"<p>This method returns the form data as a string of dataview properties. Each key-value pair in the form data is converted into a string in the format <code>key:: value</code>. Here is an example of how to use it:</p>"},{"location":"#getdata","title":"getData()","text":"<p>This method returns a copy of the form data. It can be used when you need to manipulate the form data without affecting the original data.</p>"},{"location":"#asstringtemplate-string","title":"asString(template: string)","text":"<p>This method returns the form data formatted as a string matching the provided template. The template is a string that can contain placeholders in the format <code>{{key}}</code>, which will be replaced with the corresponding value from the form data. Here is an example of how to use it in a templater template:</p> <pre><code>&lt;%*\nconst modalForm = app.plugins.plugins.modalforms.api;\nconst result = await modalForm.openForm('example-form');\ntR += result.asString('{{Name}} is {{age}} years old and his/her favorite food is {{favorite_meal}}. Family status: {{is_family}}');\n-%&gt;\n</code></pre>"},{"location":"#advanced-usage","title":"Advanced usage","text":"<p>For more advanced usage of the <code>FormResult</code> methods please refer to the specific documentation of FormResult here</p>"},{"location":"#define-a-form","title":"Define a form","text":""},{"location":"#create-a-new-form","title":"Create a new form","text":"<p>Creating a new form is easy, you just need to open the manage forms view, either by clicking on the ribbon icon or by using the command palette (<code>Obsidian modal form: New form</code>). Once there, click on the <code>+</code> button and you will be presented with a form to create a named form definition. The form is self-explanatory, but here are some key points you need to keep in mind:</p> <ul> <li>The name must be unique, and it will be used to identify the form when you open it from JavaScript, case-sensitive</li> <li>The title is what you will see as a header in the modal window when you open the form</li> <li>You will not be able to save the form unless all the fields are valid (which means they have a name and a type)</li> </ul> <p></p>"},{"location":"#dataview-integration","title":"Dataview integration","text":""},{"location":"#inline-forms","title":"Inline forms","text":"<p>The plugin also supports inline forms, which are forms that are defined when you call the openForm method. This is useful when you want to create a form that is only used in one place and it is simple enough. However, note the format is a bit verbose for typing it manually and it is error-prone, so unless it is a very small form, you will most likely prefer to use a named form.</p> <p>Here is an example of how to use it:</p> <pre><code>const modalForm = app.plugins.plugins.modalforms.api;\nconst result = await modalForm.openForm({\n    title: \"Example form\",\n    fields: [\n        {\n            name: \"name\",\n            label: \"Name\",\n            description: \"Your name\",\n            input: { type: \"text\" },\n        },\n        {\n            name: \"age\",\n            label: \"Age\",\n            description: \"Your age\",\n            input: { type: \"number\" },\n        },\n        {\n            name: \"favorite_meal\",\n            label: \"Favorite meal\",\n            description: \"Your favorite meal\",\n            input: { type: \"text\" },\n        },\n        {\n            name: \"is_family\",\n            label: \"Is family\",\n            type: \"toggle\",\n            description: \"Are you family?\",\n            required: true,\n            input: { type: \"toggle\" },\n        },\n    ],\n});\n</code></pre> <p>You can make it smaller by removing some of the optional fields like description or label, but I really encourage you to define them all.</p>"},{"location":"#tips-and-tricks","title":"Tips and tricks","text":"<ul> <li>How to make opening the forms more convenient</li> </ul>"},{"location":"#installing-the-plugin","title":"Installing the plugin","text":"<p>You can install the plugin directly from the Obsidian plugin store or through BRAT</p>"},{"location":"#installing-with-brat","title":"Installing with BRAT","text":"<ol> <li>Install the BRAT plugin (GitHub page) and enable it.</li> <li>Open the command palette and run the command BRAT: Add a beta plugin for testing.</li> <li>Enter <code>https://github.com/danielo515/obsidian-modal-form</code> into the modal and press the Add Plugin button.</li> <li>Return to the settings and navigate to the Community plugins tab.</li> <li>Enable the plugin.</li> </ol>"},{"location":"#manually-installing-the-plugin","title":"Manually installing the plugin","text":"<ul> <li>Copy over <code>main.js</code>, <code>styles.css</code>, <code>manifest.json</code> to your vault <code>VaultFolder/.obsidian/plugins/modalForm/</code>.</li> </ul>"},{"location":"#how-to-develop","title":"How to develop","text":"<ul> <li>Clone this repo.</li> <li>Make sure your NodeJS is at least v16 (<code>node --version</code>).</li> <li><code>npm i</code> or <code>yarn</code> to install dependencies.</li> <li><code>npm run dev</code> to start compilation in watch mode.</li> </ul>"},{"location":"#releasing-new-releases","title":"Releasing new releases","text":"<ul> <li>run <code>npm version patch</code>, <code>npm version minor</code>, or <code>npm version major</code> after updating <code>minAppVersion</code> manually in <code>manifest.json</code>.</li> <li>Upload the files <code>manifest.json</code>, <code>main.js</code>, <code>styles.css</code> as binary attachments. Note: The manifest.json file must be in two places, first the root path of your repository and also in the release.</li> <li>Publish the release.</li> </ul> <p>The command <code>npm version whatever</code> will bump version in <code>manifest.json</code> and <code>package.json</code>, and add the entry for the new version to <code>versions.json</code></p>"},{"location":"#publish-docs","title":"Publish docs","text":"<p>We use mkdocs to generate the documentation. To publish the docs, run:</p> <pre><code>./build-docs.sh\n</code></pre>"},{"location":"ResultValue/","title":"ResultValue","text":"<p>This class is a helper wrapper for values coming from a form Result. It provides a safer and convenient interface to render the contained value in various formats. The main purpose is to avoid the need to check for null or undefined values while having a convenient interface to print the value in a template.</p>"},{"location":"ResultValue/#usage","title":"Usage","text":"<p>All the following examples assume that the form has been opened with the following templater code:</p> <pre><code>&lt;%* const result = await forms.openForm('myForm'); %&gt;\n</code></pre>"},{"location":"ResultValue/#renderprinting-as-string","title":"Render/printing as string","text":"<p>By default, the value is rendered as a string. If the value is null or undefined, an empty string is returned. You don't need to call or do anything special to render the value as a string, just use it as if it was a string.</p> <pre><code>&lt;% result.getValue('firstField') %&gt;\n</code></pre> <p>if the value of the field is \"Hello World\", the above code will print \"Hello World\" in the resulting note. However, if the value is null or undefined, nothing will be printed.</p>"},{"location":"ResultValue/#renderprinting-as-bullet-list","title":"Render/printing as bullet list","text":"<p>You can render any value as a bullet list by using the <code>toBulletList()</code> method. If the value is an array, each element of the array will be printed as a bullet point. If the value is a primitive, like a number or a string, it will be printed as a single bullet point. If the value is null or undefined, an empty string is printed.</p> <pre><code>&lt;% result.getValue('listField').toBulletList() %&gt;\n</code></pre> <p>You can also use a shorthand for this method by using the <code>bullets</code> property:</p> <pre><code>&lt;% result.getValue('listField').bullets %&gt;\n</code></pre> <p>The above code is equivalent to the previous one.</p> <p>If the value of the field is <code>[\"Hello\", \"World\"]</code>, the above code will print:</p> <pre><code>- Hello\n- World\n</code></pre>"},{"location":"ResultValue/#renderprinting-as-dataview-field","title":"Render/printing as dataview field","text":"<p>You can render any value as a dataview field by using the <code>toDataviewField()</code> method or the shorthand <code>toDv()</code> alias.</p> <p>List values are rendered as a dataview list field, while primitive values are just rendered as a dataview field.</p> <pre><code>&lt;% result.getValue('listField').toDataviewField() %&gt;\nOr alias:\n&lt;% result.getValue('listField').toDv() %&gt;\n</code></pre> <p>if the value of the field is <code>[\"Hello\", \"World\"]</code>, the above code will print:</p> <pre><code>[listField:: \"Hello\", \"World\"]\n</code></pre> <p>If the value were a primitive, like the string \"Hello World\", the above code would print:</p> <pre><code>[listField:: Hello World]\n</code></pre>"},{"location":"ResultValue/#mapfn-value-any-any-resultvalue-method","title":"<code>map(fn: (value: any) =&gt; any): ResultValue</code> method","text":"<p>The map method is a powerful one that allows you to transform the value contained in the ResultValue object without extracting it, allowing you to chain multiple transformations.</p> <pre><code>&lt;% result.getValue('listField').map((value) =&gt; value.toUpperCase()).bullets %&gt;\n</code></pre> <p>The above code will print the list field as a bullet list, but all the values will be uppercased.</p> <p>The map method takes a function that takes the value and returns a new value. It can be used when none of the provided printing are enough for your use case, or when one of them is almost what you need but you need to transform the value a bit more.</p>"},{"location":"ResultValue/#trimmedlowerupper-shortcuts","title":"<code>trimmed</code>,<code>lower</code>,<code>upper</code> shortcuts","text":"<p>The ResultValue class provides some shortcuts to common transformations of the value. They are:</p> <ul> <li><code>trimmed</code>: Trims the value, removing any leading or trailing whitespace.</li> <li><code>lower</code>: Converts the value to lowercase.</li> <li><code>upper</code>: Converts the value to uppercase.</li> </ul> <p>All of these shortcuts return a new ResultValue object, so you can chain them with other methods.</p> <pre><code>&lt;% result.getValue('listField').trimmed.upper.bullets %&gt;\n</code></pre> <p>The above code will print the list field as a bullet list, but all the values will be uppercased and trimmed. You can chain as many or as little as you want. The most common use is probably just to use one of them, like <code>trimmed</code> or <code>upper</code>.</p> <pre><code>&lt;% result.getValue('myField').trimmed %&gt;\n</code></pre> <p>All of this shortcuts are able to handle single values and lists, so you can use them with any value.</p>"},{"location":"ResultValue/#link-method","title":"<code>link</code> method","text":"<p>The <code>link</code> method is a convenience method to render the value as a markdown link. If the value is a string, it will be rendered as a markdown link. If the value is a FileProxy (right now just used for images), it will be rendered as an embedded link. Any other type of value will be rendered as an empty string.</p> <pre><code>&lt;% result.getValue('myField').link %&gt;\n</code></pre> <p>You can also use the shorthand way of accessing values directly from the form result object, like <code>result.myField.link</code>.</p> <p>Take a look at the example vault to see how it is used.</p>"},{"location":"advanced-examples/","title":"Advanced usage examples","text":"<p>In this section of the docs you will find some advanced usage examples of modal-form-plugin</p>"},{"location":"advanced-examples/#nesting-form-calls","title":"Nesting form calls","text":""},{"location":"advanced-examples/#modifying-frontmatter-with-a-form","title":"Modifying frontmatter with a form","text":"<p>If you want to modify the content of a notes frontmatter with one of your existing forms, put the following snippet in a templater template, substituting the name of your form:</p> <pre><code>&lt;%*\nconst modalForm = app.plugins.plugins.modalforms.api;\n  const run = async (frontmatter) =&gt; {\n    const result = await modalForm.openForm('frontmatter', {\n      values: { ...frontmatter },\n    });\n    return result.getData();\n  };\n  //first we get the data from the form\n  const data = await run(tp.frontmatter);\n // Then we update the frontmatter with the new data\n  app.fileManager.processFrontMatter(\n    tp.config.target_file,\n    frontmatter =&gt; {\n      Object.assign(frontmatter, data);\n    },\n  );\n%&gt;\n</code></pre> <p>Please be aware that this is not atomic, so if if something edits the frontmatter while you are editing it within the form, the form values will not reflect this change and you may be overwriting some changes. Although this is unlikely to happen, it is better to be aware of it.</p> <p>The values the form understand and that are pressent in the frontmatter, will be populated with the values on the frontmatter. Then, when you submit the form, the new values will overwrite the old ones, leaving the rest untouched.</p>"},{"location":"advanced-examples/#making-calling-forms-more-convenient","title":"Making calling forms more convenient","text":"<p>If you are using templater, you can make calling forms more convenient by using the following snippet:</p> <pre><code>const modalForm = app.plugins.plugins.modalforms.api;\nmodule.exports = (formName, options) =&gt; modalForm.openForm(formName, options);\n</code></pre> <p>If you save this snippet as <code>openForm.js</code> in your templater snippets folder, then you can then call it like this from templater:</p> <pre><code>&lt;%*\nconst result = await tp.user.openForm('example-form', { values: { size: 'large' }});\n%&gt;\n</code></pre>"},{"location":"advanced-examples/#exclude-subfolders-when-selecting-notes-from-a-folder","title":"Exclude subfolders when selecting notes from a folder","text":"<p>Instead of using the <code>note</code> type or the <code>note</code> source (in case of multi-select) in your form, which doesn't support exclusions yet, we will use <code>dataview</code> (either type or as a multi-select source) to get the notes we want. Then use the following query to exclude subfolders:</p> <pre><code>dv.pages('\"Data\" AND -\"Data/Nested\"').file.name;\n</code></pre> <p>Here <code>Data</code> is the folder we want to get notes from and <code>Data/Nested</code> is the subfolder we want to exclude. Please keep in mind that <code>dataview</code> is very sensitive to spaces and quotes. Removing the nested <code>\"</code> will not work, or adding a space after the <code>-</code> will not work either.</p>"},{"location":"advanced-examples/#adding-additional-items-to-a-dataview-input","title":"Adding additional items to a Dataview Input","text":"<p>The <code>dataview</code> field it is just some expression that gets evaluated, and the values are what are shown in the input form. It can be a single <code>dataview</code> command, or it can be more things, like concatenation of results like this:</p> <pre><code>['1','2', ...dv.pages('#programming').title]\n</code></pre> <p>Which will look like this in the form:</p> <p></p> <p>You can take advantage of the preview to experiment a bit with what you will get in the input</p> <p></p>"},{"location":"changelog/","title":"Changelog","text":""},{"location":"changelog/#1560-2024-12-19","title":"1.56.0 (2024-12-19)","text":""},{"location":"changelog/#features","title":"Features","text":"<ul> <li>core: template service to use any available template engine to post-process templates (a3f9d4e)</li> <li>templates: ask templater to run on form template insertion (2a10a25)</li> <li>templates: offer retry on templater errors (64dae86)</li> <li>templates: post-process templates using templater (ea01cd9)</li> </ul>"},{"location":"changelog/#1550-2024-12-12","title":"1.55.0 (2024-12-12)","text":""},{"location":"changelog/#features_1","title":"Features","text":"<ul> <li>input: you can define a parent folder on the folder input (d208648)</li> </ul>"},{"location":"changelog/#bug-fixes","title":"Bug Fixes","text":"<ul> <li>remove deprecated usages (96aed30)</li> </ul>"},{"location":"changelog/#1540-2024-12-11","title":"1.54.0 (2024-12-11)","text":""},{"location":"changelog/#features_2","title":"Features","text":"<ul> <li>builder: File input builder (48b62af)</li> <li>input: file input schema and rendering (b4682ff)</li> </ul>"},{"location":"changelog/#1530-2024-12-09","title":"1.53.0 (2024-12-09)","text":""},{"location":"changelog/#features_3","title":"Features","text":"<ul> <li>input: added Image input type (cfc0cad)</li> </ul>"},{"location":"changelog/#1520-2024-09-29","title":"1.52.0 (2024-09-29)","text":""},{"location":"changelog/#features_4","title":"Features","text":"<ul> <li>form-runtime: markdown block input (567d391)</li> </ul>"},{"location":"changelog/#1510-2024-09-13","title":"1.51.0 (2024-09-13)","text":""},{"location":"changelog/#features_5","title":"Features","text":"<ul> <li>create an example vault (6c1f7c8)</li> <li>form-builder: add ability to hide fields to the UI (1af3b2d)</li> <li>form-engine: basic inputs can be hidden (6b5d17f)</li> </ul>"},{"location":"changelog/#1500-2024-07-10","title":"1.50.0 (2024-07-10)","text":""},{"location":"changelog/#features_6","title":"Features","text":"<ul> <li>logger instance (a30a9ff)</li> </ul>"},{"location":"changelog/#bug-fixes_1","title":"Bug Fixes","text":"<ul> <li>provide a logger implementation that only shows debug messages on debug (72faa20)</li> </ul>"},{"location":"changelog/#1490-2024-07-05","title":"1.49.0 (2024-07-05)","text":""},{"location":"changelog/#features_7","title":"Features","text":"<ul> <li>runtime: allow the select to be used as condition for other  fields (0d23e0b)</li> </ul>"},{"location":"changelog/#bug-fixes_2","title":"Bug Fixes","text":"<ul> <li>builder: properly save the isSet condition (1ffe488)</li> </ul>"},{"location":"changelog/#1480-2024-07-02","title":"1.48.0 (2024-07-02)","text":""},{"location":"changelog/#features_8","title":"Features","text":"<ul> <li>conditional input form builder (5f6a9be)</li> <li>runtime: conditional fields v1 (4ab141e)</li> <li>runtime: show conditional errors in the form (83a1060)</li> </ul>"},{"location":"changelog/#bug-fixes_3","title":"Bug Fixes","text":"<ul> <li>ConditionInput finally works as expected (c5d5fff)</li> </ul>"},{"location":"changelog/#1470-2024-06-22","title":"1.47.0 (2024-06-22)","text":""},{"location":"changelog/#features_9","title":"Features","text":"<ul> <li>group error messages (e0e9423)</li> <li>remove completely the old way of rendering fields (801d331)</li> <li>runtime: svelte versions of DocumentBlock and InputNote (968d230)</li> </ul>"},{"location":"changelog/#bug-fixes_4","title":"Bug Fixes","text":"<ul> <li>runtime: input tag in svelte (879aba9)</li> <li>runtime: svelte wrappers for obsidian settings (37f5236)</li> </ul>"},{"location":"changelog/#1460-2024-06-17","title":"1.46.0 (2024-06-17)","text":""},{"location":"changelog/#features_10","title":"Features","text":"<ul> <li>util: insert a form template into current note command (d60fe82)</li> </ul>"},{"location":"changelog/#bug-fixes_5","title":"Bug Fixes","text":"<ul> <li>templater: remove empty lines (eda92a2)</li> </ul>"},{"location":"changelog/#1452-2024-06-10","title":"1.45.2 (2024-06-10)","text":""},{"location":"changelog/#bug-fixes_6","title":"Bug Fixes","text":"<ul> <li>runtime: better weights in file suggestions  (aac26d1), closes #272</li> </ul>"},{"location":"changelog/#1451-2024-06-04","title":"1.45.1 (2024-06-04)","text":""},{"location":"changelog/#bug-fixes_7","title":"Bug Fixes","text":"<ul> <li>templater: flex wrap (4aed840)</li> </ul>"},{"location":"changelog/#1450-2024-06-04","title":"1.45.0 (2024-06-04)","text":""},{"location":"changelog/#features_11","title":"Features","text":"<ul> <li>templater: customize result name in template builder (16a2297)</li> <li>templater: easily build template body (b705136)</li> </ul>"},{"location":"changelog/#1441-2024-05-31","title":"1.44.1 (2024-05-31)","text":""},{"location":"changelog/#bug-fixes_8","title":"Bug Fixes","text":"<ul> <li>show title in the template builder (012901d)</li> </ul>"},{"location":"changelog/#1440-2024-05-30","title":"1.44.0 (2024-05-30)","text":""},{"location":"changelog/#features_12","title":"Features","text":"<ul> <li>more customizations in the generated template (6db7d29)</li> </ul>"},{"location":"changelog/#bug-fixes_9","title":"Bug Fixes","text":"<ul> <li>easy toggle all for fields to include in frontmatter (8bf4fb4)</li> </ul>"},{"location":"changelog/#1430-2024-05-30","title":"1.43.0 (2024-05-30)","text":""},{"location":"changelog/#features_13","title":"Features","text":"<ul> <li>ability to open template builder form UI (c6663ff)</li> <li>add a view for template builder (f32ebfb)</li> <li>copy to clipboard and better format (e3e3249)</li> <li>open TemplateBuilder in a modal (e376cd0)</li> <li>std: updateFirst for Array (e6f28e1)</li> </ul>"},{"location":"changelog/#1421-2024-05-14","title":"1.42.1 (2024-05-14)","text":""},{"location":"changelog/#bug-fixes_10","title":"Bug Fixes","text":"<ul> <li>set initial value of fixed-source select fields, if provided (8864226)</li> </ul>"},{"location":"changelog/#1420-2024-05-13","title":"1.42.0 (2024-05-13)","text":""},{"location":"changelog/#features_14","title":"Features","text":"<ul> <li>cancel esc button for cancel the form (ea350bf)</li> </ul>"},{"location":"changelog/#bug-fixes_11","title":"Bug Fixes","text":"<ul> <li>formEngine: gracefully handle the close of the form (a398882)</li> </ul>"},{"location":"changelog/#1410-2024-05-10","title":"1.41.0 (2024-05-10)","text":""},{"location":"changelog/#features_15","title":"Features","text":"<ul> <li>input: dataview input can be fully async (cac23bb)</li> <li>input: document block is async (1e23a1b)</li> <li>std: make the function evaluator async and handle TE (239a4d5)</li> <li>suggesters: DataviewSuggest is now async (dae4a25)</li> <li>suggesters: make SafeDataviewQuery async (239a4d5)</li> </ul>"},{"location":"changelog/#1404-2024-04-25","title":"1.40.4 (2024-04-25)","text":""},{"location":"changelog/#bug-fixes_12","title":"Bug Fixes","text":"<ul> <li>make the editor headers stick only on big screens (4193246)</li> </ul>"},{"location":"changelog/#1403-2024-04-20","title":"1.40.3 (2024-04-20)","text":""},{"location":"changelog/#bug-fixes_13","title":"Bug Fixes","text":"<ul> <li>allow decimal inputs for number fields (b70e99a), closes #237</li> </ul>"},{"location":"changelog/#1402-2024-01-22","title":"1.40.2 (2024-01-22)","text":""},{"location":"changelog/#bug-fixes_14","title":"Bug Fixes","text":"<ul> <li>support html in the document_block (1717937)</li> </ul>"},{"location":"changelog/#1401-2024-01-21","title":"1.40.1 (2024-01-21)","text":""},{"location":"changelog/#bug-fixes_15","title":"Bug Fixes","text":"<ul> <li>a bit better import UI (024b513)</li> <li>button to open import modal from form manager (1cc834e)</li> </ul>"},{"location":"changelog/#1400-2024-01-21","title":"1.40.0 (2024-01-21)","text":""},{"location":"changelog/#features_16","title":"Features","text":"<ul> <li>API: expose some utils (eb54365)</li> <li>import form modal (a844983)</li> <li>import: ability to edit forms imported from JSON (6cdb104)</li> </ul>"},{"location":"changelog/#1391-2024-01-17","title":"1.39.1 (2024-01-17)","text":""},{"location":"changelog/#bug-fixes_16","title":"Bug Fixes","text":"<ul> <li>tag should allow unknown values (4dec090)</li> </ul>"},{"location":"changelog/#1390-2024-01-14","title":"1.39.0 (2024-01-14)","text":""},{"location":"changelog/#features_17","title":"Features","text":"<ul> <li>multi select notes uses the new notes input (better UI and search) (6c3e1e5)</li> </ul>"},{"location":"changelog/#1380-2024-01-13","title":"1.38.0 (2024-01-13)","text":""},{"location":"changelog/#features_18","title":"Features","text":"<ul> <li>core: enrich_tfile utility function (1cf4508)</li> <li>form: the input file is now fuzzy over path and tags. It shows a nicer UI that includes the path (38dc4b3)</li> <li>input: note suggest shows the parent folder of the note (6409ebf)</li> </ul>"},{"location":"changelog/#1370-2024-01-06","title":"1.37.0 (2024-01-06)","text":""},{"location":"changelog/#features_19","title":"Features","text":"<ul> <li>command to directly edit a form (47d4d8c)</li> </ul>"},{"location":"changelog/#1361-2024-01-06","title":"1.36.1 (2024-01-06)","text":""},{"location":"changelog/#bug-fixes_17","title":"Bug Fixes","text":"<ul> <li>form-runtime: show an asterisk when fields are required (b578ace), closes #198</li> </ul>"},{"location":"changelog/#1360-2024-01-02","title":"1.36.0 (2024-01-02)","text":""},{"location":"changelog/#features_20","title":"Features","text":"<ul> <li>allow any value in multi-select dataview (fa9da3d), closes #54</li> <li>multi-select fixed can allow unknown values (dcefe7c)</li> <li>tags input allow any value to be selected, even if it does not exist yet (1834bf5)</li> </ul>"},{"location":"changelog/#1350-2024-01-01","title":"1.35.0 (2024-01-01)","text":""},{"location":"changelog/#features_21","title":"Features","text":"<ul> <li>option to have a global shortcut to modal form (d262a0e)</li> </ul>"},{"location":"changelog/#1340-2023-12-29","title":"1.34.0 (2023-12-29)","text":""},{"location":"changelog/#features_22","title":"Features","text":"<ul> <li>dataview query preview in FormBuilder (0a5b4cd)</li> <li>real time query preview with errors (41a7dec)</li> </ul>"},{"location":"changelog/#1330-2023-12-28","title":"1.33.0 (2023-12-28)","text":""},{"location":"changelog/#features_23","title":"Features","text":"<ul> <li>dataview rendering method for FormValue (86839ce)</li> <li>FormResult is now a proxy, so you can access the contained result values safely and directly (3f4a611)</li> <li>result value helpers for better user experience (57f2c1b)</li> <li>shortcut methods for the ResultValue helper (00ba405)</li> </ul>"},{"location":"changelog/#1321-2023-12-22","title":"1.32.1 (2023-12-22)","text":""},{"location":"changelog/#bug-fixes_18","title":"Bug Fixes","text":"<ul> <li>inline help for dataview (d7e0630)</li> </ul>"},{"location":"changelog/#1320-2023-12-17","title":"1.32.0 (2023-12-17)","text":""},{"location":"changelog/#features_24","title":"Features","text":"<ul> <li>template: add support for frontmatter command in templates (059891c)</li> </ul>"},{"location":"changelog/#1310-2023-12-17","title":"1.31.0 (2023-12-17)","text":""},{"location":"changelog/#features_25","title":"Features","text":"<ul> <li>added a get method for result data fixes #129 (ddee8a8)</li> </ul>"},{"location":"changelog/#bug-fixes_19","title":"Bug Fixes","text":"<ul> <li>add aliases for Result methods fixes #122 (d6f755c)</li> </ul>"},{"location":"changelog/#1301-2023-12-16","title":"1.30.1 (2023-12-16)","text":""},{"location":"changelog/#bug-fixes_20","title":"Bug Fixes","text":"<ul> <li>creation of unique note name (b40b2c3)</li> <li>prevent chalk to be loaded in bundle (37e4508)</li> </ul>"},{"location":"changelog/#1300-2023-12-15","title":"1.30.0 (2023-12-15)","text":""},{"location":"changelog/#features_26","title":"Features","text":"<ul> <li>create new notes from forms using templates (2a5d1bc)</li> </ul>"},{"location":"changelog/#1290-2023-12-08","title":"1.29.0 (2023-12-08)","text":""},{"location":"changelog/#features_27","title":"Features","text":"<ul> <li>input: new input folder suggester (2102619), closes #148</li> </ul>"},{"location":"changelog/#1280-2023-12-07","title":"1.28.0 (2023-12-07)","text":""},{"location":"changelog/#features_28","title":"Features","text":"<ul> <li>API: example form takes options (d204786)</li> <li>core: throttle error messages (60157bd)</li> <li>document how to make more convenient opening forms (0c70eae), closes #145</li> <li>form-editor: UI to set fields as required (c77c340)</li> <li>form-runtime: the form is now reactive (ad82789)</li> <li>validation: better UI for notify errors of form (2a609ae)</li> </ul>"},{"location":"changelog/#bug-fixes_21","title":"Bug Fixes","text":"<ul> <li>add a link to the docs in the settings (704aa99), closes #58</li> <li>functional form engine (ab99b0e)</li> <li>input: multi-select refocus on enter (6f8d2ca)</li> <li>preettier invalid form view in form manager (b256a1a)</li> </ul>"},{"location":"changelog/#1271-2023-11-23","title":"1.27.1 (2023-11-23)","text":""},{"location":"changelog/#bug-fixes_22","title":"Bug Fixes","text":"<ul> <li>remove leading # in tags (556b769)</li> </ul>"},{"location":"changelog/#1270-2023-11-22","title":"1.27.0 (2023-11-22)","text":""},{"location":"changelog/#features_29","title":"Features","text":"<ul> <li>input: tag suggest input, initial version (9f0d8af), closes #118</li> </ul>"},{"location":"changelog/#1260-2023-11-07","title":"1.26.0 (2023-11-07)","text":""},{"location":"changelog/#features_30","title":"Features","text":"<ul> <li>ability to add a custom class name to the form body (28d81b9), closes #125</li> </ul>"},{"location":"changelog/#1250-2023-11-06","title":"1.25.0 (2023-11-06)","text":""},{"location":"changelog/#features_31","title":"Features","text":"<ul> <li>make the dataview input more fuzzy (1971fdc)</li> </ul>"},{"location":"changelog/#1241-2023-11-04","title":"1.24.1 (2023-11-04)","text":""},{"location":"changelog/#bug-fixes_23","title":"Bug Fixes","text":"<ul> <li>input: if folder does not exist, the form does not fail (0d5afbd), closes #90</li> </ul>"},{"location":"changelog/#1240-2023-11-03","title":"1.24.0 (2023-11-03)","text":""},{"location":"changelog/#features_32","title":"Features","text":"<ul> <li>editor: create dataview inputs (75f71f1)</li> <li>inputs: dataview can be used as source for multi-select (cd39785), closes #50</li> </ul>"},{"location":"changelog/#1230-2023-11-02","title":"1.23.0 (2023-11-02)","text":""},{"location":"changelog/#features_33","title":"Features","text":"<ul> <li>specific field/input error reporting methods (3bfd22d)</li> </ul>"},{"location":"changelog/#bug-fixes_24","title":"Bug Fixes","text":"<ul> <li>forms can not be renamed (ab2e20d), closes #108</li> <li>ManageForms view is now reactive thanks to stores (040f8f5)</li> </ul>"},{"location":"changelog/#1221-2023-10-26","title":"1.22.1 (2023-10-26)","text":""},{"location":"changelog/#bug-fixes_25","title":"Bug Fixes","text":"<ul> <li>big bundle size (e5f566e)</li> </ul>"},{"location":"changelog/#1220-2023-10-26","title":"1.22.0 (2023-10-26)","text":""},{"location":"changelog/#features_34","title":"Features","text":"<ul> <li>allow pick/omit in Result helpers (1c5bd5f), closes #101</li> </ul>"},{"location":"changelog/#bug-fixes_26","title":"Bug Fixes","text":"<ul> <li>add tests for result class and helpers (e4eea18)</li> <li>dataview list format is now correct (e4eea18)</li> </ul>"},{"location":"changelog/#1210-2023-10-25","title":"1.21.0 (2023-10-25)","text":""},{"location":"changelog/#features_35","title":"Features","text":"<ul> <li>detect invalid data on data.json (91aa99c), closes #98</li> <li>migrate between form format versions (b4e6c96), closes #92</li> </ul>"},{"location":"changelog/#bug-fixes_27","title":"Bug Fixes","text":"<ul> <li>add version to the form definition (c7fdd77)</li> <li>proper duplicate scroll (28cebd4)</li> </ul>"},{"location":"changelog/#1200-2023-10-22","title":"1.20.0 (2023-10-22)","text":""},{"location":"changelog/#features_36","title":"Features","text":"<ul> <li>Enable Ctrl+Enter form submission (#60) (7f72122)</li> </ul>"},{"location":"changelog/#1190-2023-10-22","title":"1.19.0 (2023-10-22)","text":""},{"location":"changelog/#features_37","title":"Features","text":"<ul> <li>Export form as JSON button (#29) (defc86c)</li> <li>scroll to elements on the list (f9804a7)</li> <li>scroll to new fields in the editor (ce3ece5)</li> </ul>"},{"location":"changelog/#bug-fixes_28","title":"Bug Fixes","text":"<ul> <li>accept empty option values for now (6293dad)</li> <li>ensure types in svelte at build (fbe03d3)</li> <li>pipelines install (2c9a17f)</li> <li>type check also svelte files (903b9bf)</li> <li>type narrow on svelte (c46dc40)</li> </ul>"},{"location":"changelog/#1180-2023-10-21","title":"1.18.0 (2023-10-21)","text":""},{"location":"changelog/#features_38","title":"Features","text":"<ul> <li>ability to order select options (#64) (b955726)</li> </ul>"},{"location":"changelog/#1170-2023-10-20","title":"1.17.0 (2023-10-20)","text":""},{"location":"changelog/#features_39","title":"Features","text":"<ul> <li>added tests (1230a34)</li> <li>show errors when form has any invalid field (54e9eaf)</li> </ul>"},{"location":"changelog/#1166-2023-10-19","title":"1.16.6 (2023-10-19)","text":""},{"location":"changelog/#bug-fixes_29","title":"Bug Fixes","text":"<ul> <li>remove all trace of text input suggest (68cace2)</li> </ul>"},{"location":"changelog/#1165-2023-10-19","title":"1.16.5 (2023-10-19)","text":""},{"location":"changelog/#bug-fixes_30","title":"Bug Fixes","text":"<ul> <li>separate input builder for select (e75a1f4), closes #75</li> </ul>"},{"location":"changelog/#1164-2023-10-16","title":"1.16.4 (2023-10-16)","text":""},{"location":"changelog/#bug-fixes_31","title":"Bug Fixes","text":"<ul> <li>do not close existing leafs, reuse instead (b00b6b8), closes #36</li> <li>open the main view in a new tab (b00b6b8)</li> </ul>"},{"location":"changelog/#1163-2023-10-16","title":"1.16.3 (2023-10-16)","text":""},{"location":"changelog/#bug-fixes_32","title":"Bug Fixes","text":"<ul> <li>text-area initial value (f21b783)</li> </ul>"},{"location":"changelog/#1162-2023-10-11","title":"1.16.2 (2023-10-11)","text":""},{"location":"changelog/#bug-fixes_33","title":"Bug Fixes","text":"<ul> <li>make multi-select static work (fa5987a), closes #63</li> </ul>"},{"location":"changelog/#1161-2023-10-10","title":"1.16.1 (2023-10-10)","text":""},{"location":"changelog/#bug-fixes_34","title":"Bug Fixes","text":"<ul> <li>ensure order of fixed select (62b407e), closes #61</li> </ul>"},{"location":"changelog/#1160-2023-10-03","title":"1.16.0 (2023-10-03)","text":""},{"location":"changelog/#features_40","title":"Features","text":"<ul> <li>add multi-line text area (1cf1559), closes #46</li> </ul>"},{"location":"changelog/#1150-2023-10-02","title":"1.15.0 (2023-10-02)","text":""},{"location":"changelog/#features_41","title":"Features","text":"<ul> <li>default values support for most input types (f8415a3)</li> </ul>"},{"location":"changelog/#bug-fixes_35","title":"Bug Fixes","text":"<ul> <li>do not use innerHTML (8ae7d5b)</li> </ul>"},{"location":"changelog/#1141-2023-09-29","title":"1.14.1 (2023-09-29)","text":""},{"location":"changelog/#bug-fixes_36","title":"Bug Fixes","text":"<ul> <li>properly clone elements (667ebe0), closes #51</li> <li>set a default value for inputs of type select (2c514b1), closes #45</li> </ul>"},{"location":"changelog/#1140-2023-09-15","title":"1.14.0 (2023-09-15)","text":""},{"location":"changelog/#features_42","title":"Features","text":"<ul> <li>show result preview (7425df1)</li> </ul>"},{"location":"changelog/#bug-fixes_37","title":"Bug Fixes","text":"<ul> <li>filtering in multi with uppercase (fac67ea)</li> <li>multi select was not including the values (1885834)</li> </ul>"},{"location":"changelog/#1130-2023-09-15","title":"1.13.0 (2023-09-15)","text":""},{"location":"changelog/#features_43","title":"Features","text":"<ul> <li>limitedForm api (b0acb29), closes #39</li> </ul>"},{"location":"changelog/#1121-2023-09-15","title":"1.12.1 (2023-09-15)","text":""},{"location":"changelog/#bug-fixes_38","title":"Bug Fixes","text":"<ul> <li>make sure the editor always has the right height (53f10b3), closes #38</li> </ul>"},{"location":"changelog/#1120-2023-09-15","title":"1.12.0 (2023-09-15)","text":""},{"location":"changelog/#features_44","title":"Features","text":"<ul> <li>multi select UI builder (3eff7a8)</li> <li>multi-select v1 (e3ee492)</li> </ul>"},{"location":"changelog/#bug-fixes_39","title":"Bug Fixes","text":"<ul> <li>proper colors for save and close (4c6d495)</li> <li>toggles always have a value (72cfc3e)</li> </ul>"},{"location":"changelog/#1110-2023-09-14","title":"1.11.0 (2023-09-14)","text":""},{"location":"changelog/#features_45","title":"Features","text":"<ul> <li>preview form from the editor (2d8e2d6), closes #17</li> </ul>"},{"location":"changelog/#1100-2023-09-14","title":"1.10.0 (2023-09-14)","text":""},{"location":"changelog/#features_46","title":"Features","text":"<ul> <li>show better errors (8202d37)</li> </ul>"},{"location":"changelog/#bug-fixes_40","title":"Bug Fixes","text":"<ul> <li>dataview input was not filtering (8202d37)</li> </ul>"},{"location":"changelog/#191-2023-09-14","title":"1.9.1 (2023-09-14)","text":""},{"location":"changelog/#bug-fixes_41","title":"Bug Fixes","text":"<ul> <li>release process (790d84d)</li> </ul>"},{"location":"changelog/#190-2023-09-14","title":"1.9.0 (2023-09-14)","text":""},{"location":"changelog/#features_47","title":"Features","text":"<ul> <li>keep the form header always visible (216d9b4), closes #11</li> </ul>"},{"location":"changelog/#bug-fixes_42","title":"Bug Fixes","text":"<ul> <li>release-bot (0586068)</li> </ul>"},{"location":"changelog/#180-2023-09-13","title":"1.8.0 (2023-09-13)","text":""},{"location":"changelog/#features_48","title":"Features","text":"<ul> <li>dataview input type (22b8949)</li> </ul>"},{"location":"changelog/#171-2023-09-13","title":"1.7.1 (2023-09-13)","text":""},{"location":"changelog/#bug-fixes_43","title":"Bug Fixes","text":"<ul> <li>remove deprecated usages of app (343ff57)</li> </ul>"},{"location":"changelog/#170-2023-09-12","title":"1.7.0 (2023-09-12)","text":""},{"location":"changelog/#features_49","title":"Features","text":"<ul> <li>duplicate form (7a0f1c6), closes #20</li> </ul>"},{"location":"changelog/#bug-fixes_44","title":"Bug Fixes","text":"<ul> <li>fix the versioning, I hope (7bb7d7d)</li> </ul>"},{"location":"changelog/#160-2023-09-12","title":"1.6.0 (2023-09-12)","text":""},{"location":"changelog/#features_50","title":"Features","text":"<ul> <li>allow to duplicate fields (21777e9), closes #20</li> </ul>"},{"location":"changelog/#150-2023-09-12","title":"1.5.0 (2023-09-12)","text":""},{"location":"changelog/#features_51","title":"Features","text":"<ul> <li>ability to cancel edits to a form (f90d7f0), closes #8</li> </ul>"},{"location":"changelog/#140-2023-09-11","title":"1.4.0 (2023-09-11)","text":""},{"location":"changelog/#features_52","title":"Features","text":"<ul> <li>decide where to open the forms editor/manager (bd5a957)</li> </ul>"},{"location":"changelog/#bug-fixes_45","title":"Bug Fixes","text":"<ul> <li>make field name required (2892503)</li> </ul>"},{"location":"changelog/#130-2023-09-11","title":"1.3.0 (2023-09-11)","text":""},{"location":"changelog/#features_53","title":"Features","text":"<ul> <li>ability to order fields (79517c0)</li> </ul>"},{"location":"changelog/#122-2023-09-11","title":"1.2.2 (2023-09-11)","text":""},{"location":"changelog/#bug-fixes_46","title":"Bug Fixes","text":"<ul> <li>rename the plugin to follow obsidian guidelines (2487590)</li> </ul>"},{"location":"changelog/#121-2023-09-11","title":"1.2.1 (2023-09-11)","text":""},{"location":"changelog/#bug-fixes_47","title":"Bug Fixes","text":"<ul> <li>do not include v in tag (7a54a24)</li> </ul>"},{"location":"changelog/#120-2023-09-11","title":"1.2.0 (2023-09-11)","text":""},{"location":"changelog/#features_54","title":"Features","text":"<ul> <li>complete core decoding and validation (7fc538c)</li> <li>FormEditor V1 (ce228ef)</li> <li>manage forms view (bb99d2d)</li> <li>mobile handling of the form editor (1be84bd)</li> <li>suggest folder input (3adaf07)</li> </ul>"},{"location":"changelog/#bug-fixes_48","title":"Bug Fixes","text":"<ul> <li>delete forms (70c6a77)</li> <li>icons (fca57dd)</li> </ul>"},{"location":"changelog/#110-2023-09-07","title":"1.1.0 (2023-09-07)","text":""},{"location":"changelog/#features_55","title":"Features","text":"<ul> <li>asString using template (5041673)</li> <li>real API v1 (1a8da2f)</li> <li>slider (bb9c0b5)</li> </ul>"},{"location":"changelog/#100-2023-09-06","title":"1.0.0 (2023-09-06)","text":""},{"location":"changelog/#features_56","title":"Features","text":"<ul> <li>add support for all the basic fields (991c53e)</li> <li>dataview serialization (9b38402)</li> <li>form result (2f63a90)</li> <li>initial prototype (ae1404a)</li> <li>note input with autocomplete and narrowed to specific folder (89bce4c)</li> <li>select input for notes narrowed to specific folder (89bce4c)</li> <li>select input with fixed number of elements (89bce4c)</li> <li>support numbers and text (5b27caf)</li> </ul>"},{"location":"import-forms/","title":"Importing a form","text":""},{"location":"import-forms/#importing-forms","title":"Importing Forms","text":"<p>Since release 1.40.0 it is possible to import forms from JSON. You can open the import modal from the command palette or from the forms list. The command is called <code>Import Form</code> for the surprise of no one. That will present a simple modal with a text area where you can paste the JSON. Any errors will appear next to the text area if any. Once you fix the errors you can click the <code>Import</code> button which will open the form editor with the imported form. From there you can do any changes you want and save it. </p>"},{"location":"long-list-tip/","title":"TIP: How to put a long list of values in a select without having to type them one by one","text":"<p>When you already have a long list of values that you want in a select input, instead of putting them one by one in the fixed list, you can use the <code>dataview</code> input type and just return the values as an array in the dataview query.</p> <p>For example, you can put the following in a select input with <code>dataview</code> as the source:</p> <pre><code>return [\n    'Wash the dishes',\n    'Take out the trash',\n    'Do the laundry',\n    'Mow the lawn',\n    'Feed the cat',\n    'Feed the dog',\n    'Feed the fish',\n    'Feed the birds',\n    'Feed the turtles',\n    'Feed the rabbits',\n    'Feed the turtles',]\n</code></pre> <p>And the result will be: </p> <p>Here is an screenshot of how it looks in the form builder: </p>"},{"location":"managing-results/","title":"Managing Results","text":"<p>The <code>FormResult</code> class provides methods for accessing and formatting form results.</p> <p>[!TIP] From version <code>1.33.0</code> onwards, the <code>FormResult</code> class allows accessing the values of the form fields  using directly <code>property accessors</code>, like <code>result.title</code> or <code>result.listField</code>. The property accessors are equivalent to calling the <code>get</code> method, so <code>result.title</code> is equivalent to <code>result.get('title')</code>, but it's shorter and more convenient. All the examples in this page continue to use the more explicit ways to access the values, but you can use the property accessors if you prefer.</p> <p>[!IMPORTANT] Accessing the values using <code>property accessors</code> or the <code>getValue</code> method is considered the safer and preferred way to access the values. This is because the returned values are wrapped in a <code>ResultValue</code> object that provides a safer and more convenient interface to render the values in various formats.</p>"},{"location":"managing-results/#asfrontmatterstringoptions-unknown-string","title":"<code>asFrontmatterString(options?: unknown): string</code>","text":"<p>Transforms the current data into a frontmatter string, which is expected to be enclosed in <code>---</code> when used in a markdown file. This method does not add the enclosing <code>---</code> to the string, so you can put it anywhere inside the frontmatter.</p>"},{"location":"managing-results/#parameters","title":"Parameters","text":"<ul> <li> <p><code>options</code> (optional): An options object describing what options to pick or omit.</p> <ul> <li><code>pick</code> (optional): An array of key names to pick from the data.</li> <li><code>omit</code> (optional): An array of key names to omit from the data.</li> </ul> </li> </ul>"},{"location":"managing-results/#returns","title":"Returns","text":"<ul> <li><code>string</code>: The data formatted as a frontmatter string.</li> </ul>"},{"location":"managing-results/#example","title":"Example","text":"<pre><code>const result = await form.openForm(\"my-form\");\ntR += result.asFrontmatterString({ pick: [\"title\"] });\n</code></pre>"},{"location":"managing-results/#aliases","title":"Aliases","text":"<p>this method has the following aliases:</p> <ul> <li><code>asFrontmatter</code></li> <li><code>asYaml</code></li> </ul>"},{"location":"managing-results/#asdataviewpropertiesoptions-unknown-string","title":"<code>asDataviewProperties(options?: unknown): string</code>","text":"<p>Returns the current data as a block of dataview properties.</p>"},{"location":"managing-results/#parameters_1","title":"Parameters","text":"<ul> <li> <p><code>options</code> (optional): An options object describing what options to pick or omit.</p> <ul> <li><code>pick</code> (optional): An array of key names to pick from the data.</li> <li><code>omit</code> (optional): An array of key names to omit from the data.</li> </ul> </li> </ul>"},{"location":"managing-results/#returns_1","title":"Returns","text":"<ul> <li><code>string</code>: The data formatted as a block of dataview properties.</li> </ul>"},{"location":"managing-results/#example_1","title":"Example","text":"<pre><code>const result = await form.openForm('my-form')\ntR += result.asDataviewProperties({ pick: ['title'] });`\n</code></pre>"},{"location":"managing-results/#aliases_1","title":"Aliases","text":"<p>This method has the following aliases:</p> <ul> <li><code>asDataview</code></li> <li><code>asDv</code></li> </ul>"},{"location":"managing-results/#getkey-string-mapfn-value-any-any-any","title":"<code>get(key: string, mapFn?: (value: any) =&gt; any): any</code>","text":"<p>Returns the value of the given key. If the key does not exist, returns the empty string <code>\"\"</code>. It takes an optional map function that can be used to transform the value. If the key does not exist, the map function is not called.</p>"},{"location":"managing-results/#parameters_2","title":"Parameters","text":"<ul> <li><code>key</code>: The key to get the value of.</li> <li><code>mapFn</code> (optional): A function that takes the value and returns a new value.</li> </ul>"},{"location":"managing-results/#returns_2","title":"Returns","text":"<ul> <li><code>any</code>: The value of the given key.</li> </ul>"},{"location":"managing-results/#example_2","title":"Example","text":"<pre><code>const result = await form.openForm(\"my-form\");\ntR += result.get(\"title\");\n</code></pre> <p>Or with a map function:</p> <pre><code>const result = await form.openForm(\"my-form\");\ntR += result.get(\"title\", (value) =&gt; value.toUpperCase());\n</code></pre>"},{"location":"managing-results/#getvaluekey-string-resultvalue-or-getvkey-string-resultvalue","title":"<code>getValue(key: string): ResultValue</code> or <code>getV(key: string): ResultValue</code>","text":"<p>Returns the value of the given key as a <code>ResultValue</code> object.</p>"},{"location":"managing-results/#parameters_3","title":"Parameters","text":"<ul> <li><code>key</code>: The key to get the value of.</li> </ul>"},{"location":"managing-results/#returns_3","title":"Returns","text":"<ul> <li><code>ResultValue</code>: The value of the given key as a <code>ResultValue</code> object.  If the key field doesn't exist or is empty, returns an empty <code>ResultValue</code> object. Thanks to this, you don't need to check if the field exists or is empty because the <code>ResultValue</code> object will handle it for you.</li> </ul>"},{"location":"managing-results/#example_3","title":"Example","text":"<pre><code>const result = await form.openForm(\"my-form\");\ntR += result.getValue(\"title\");\ntR += result.getValue(\"listField\").bullets;\n</code></pre> <p>Thanks to <code>property accessors</code>, you can also write the above code in a more convenient way like this:</p> <pre><code>const result = await form.openForm(\"my-form\");\ntR += result.title;\ntR += result.listField.bullets;\n</code></pre> <p>For more details and examples, see the <code>ResultValue</code> documentation.</p>"},{"location":"templates/","title":"Templates","text":"<p>Templates allow you to bind dynamic text outputs to your forms. Forms that have templates binded to them are subject to be used to create new notes or to insert them. If you use either the command to create a new note from a form or the insert form command, after the form is submitted its template will be processed using the form's values to generate the final text. After the form template is processed, if you have the templater plugin installed, the final text will be processed by templater. See the Templater Support section for more information.</p>"},{"location":"templates/#template-syntax","title":"Template Syntax","text":"<p>A template consists of plain text mixed with variables and commands:</p> <ul> <li>Variables: Wrapped in double curly braces <code>{{ }}</code>, they are replaced with form field values</li> <li>Commands: Special instructions wrapped in <code>{{# #}}</code> that control template behavior</li> </ul>"},{"location":"templates/#variables","title":"Variables","text":"<p>Variables are placeholders that get replaced with form field values. The variable name must match a field name from your form:</p> <pre><code>Hello {{name}}! Your favorite color is {{color}}.\n</code></pre>"},{"location":"templates/#basic-variable-syntax","title":"Basic Variable Syntax","text":"<ul> <li>Variable Declaration:</li> </ul> <p><code>plaintext   {{ variableName }}</code></p> <p>Example:</p> <p><code>plaintext   {{ name }}</code></p> <p>Note that spaces around the variable name are ignored, allowing for flexibility in formatting.</p> <pre><code>This is a {{variableName}}. And this is also a valid {{ variableName }}\n</code></pre>"},{"location":"templates/#variable-with-transformations","title":"Variable with Transformations","text":"<ul> <li>Transformation Syntax: You can apply transformations to a variable by using a pipe <code>|</code> followed by the transformation name.</li> </ul> <p><code>plaintext   {{ variableName | transformation }}</code></p> <p>Example:</p> <p><code>plaintext   {{ name | trim }}</code></p>"},{"location":"templates/#supported-transformations","title":"Supported Transformations","text":"<p>The following transformations can be applied to variables:</p> <ol> <li><code>upper</code>: Converts the variable's value to uppercase.</li> <li> <p>Usage:</p> <p><code>plaintext  {{ name | upper }}</code></p> </li> <li> <p><code>lower</code>: Converts the variable's value to lowercase.</p> </li> <li> <p>Usage:</p> <p><code>plaintext  {{ name | lower }}</code></p> </li> <li> <p><code>trim</code>: Removes whitespace from both ends of the variable's value.</p> </li> <li> <p>Usage:</p> <p><code>plaintext  {{ name | trim }}</code></p> </li> <li> <p><code>stringify</code>: Converts the variable's value to a JSON string.</p> </li> <li> <p>Usage:</p> <p><code>plaintext  {{ name | stringify }}</code></p> </li> </ol>"},{"location":"templates/#example-templates","title":"Example Templates","text":"<p>Here are some examples of how to use the new template syntax:</p> <ul> <li>Single Variable:</li> </ul> <p><code>plaintext   Hello, {{ name }}!</code></p> <ul> <li>Variable with Transformation:</li> </ul> <p><code>plaintext   Hello, {{ name | upper }}!</code></p> <ul> <li>Multiple Variables with Transformations:</li> </ul> <p><code>plaintext   Hello, {{ name | trim }}! You are {{ age }} years old.</code></p>"},{"location":"templates/#notes","title":"Notes","text":"<ul> <li>If an invalid transformation is specified, it will be silently ignored, and the variable will be processed without transformation.</li> <li>Spaces around the transformation operator (<code>|</code>) are ignored, allowing for flexibility in formatting:</li> </ul> <p><code>plaintext   {{ name | trim }} or {{ name|trim }} are both valid.</code></p>"},{"location":"templates/#available-commands","title":"Available Commands","text":""},{"location":"templates/#frontmatter-command","title":"Frontmatter Command","text":"<p>The frontmatter command controls which form fields appear in the YAML frontmatter section of your note:</p> <pre><code>{# frontmatter pick: title, tags #}\n</code></pre> <p>Options:</p> <ul> <li><code>pick</code>: Only include these specific fields in the frontmatter</li> <li><code>omit</code>: Exclude these fields from the frontmatter</li> </ul> <p>You can combine both options:</p> <pre><code>{# frontmatter pick: title, tags, date omit: draft #}\n</code></pre> <p>If no options are specified, all form fields will be included in the frontmatter:</p> <pre><code>{# frontmatter #}\n</code></pre>"},{"location":"templates/#templater-support","title":"Templater Support","text":"<p>If you have the Templater plugin installed, Modal Form will also process any templater syntax in your form templates. This means you can combine both the form template variables and templater syntax in your templates.</p> <p>For example:</p> <pre><code>Hello {{NAME}},\nToday is &lt;% tp.date.now() %&gt; and you are using form templates!\n</code></pre> <p>The form will first replace <code>{{NAME}}</code> with the value from your form, and then Templater will process its own syntax (like <code>&lt;% tp.date.now() %&gt;</code>) afterwards.</p> <p>Note: This feature is only available if you have the Templater plugin installed and enabled in your vault.</p>"},{"location":"templates/#example","title":"Example","text":"<p>Here's a complete template example that combines variables and frontmatter:</p> <pre><code>{# frontmatter pick: title, tags #}\n\n# {{title}}\n\nDear {{name}},\n\nThank you for your {{type}} submission about {{topic}}.\n\nBest regards,\n{{signature}}\n</code></pre>"},{"location":"blog/","title":"Blog","text":""},{"location":"blog/2024/06/15/release-notes-for-1460/","title":"Release notes for 1.46.0","text":"<p>This release contains one little change that was easy to make, but I think that it unlocks a very interesting use case for modal forms. There is a not very well documented feature in the FormEditor that allows to define a specific (and simple) template linked to that form. I implemented it partially for fun, because I love coding parsers but also partially because many times I only need very basic templating functionality and I don't want to have to write another templater template. Also, I find very appealing the idea of having both the form and the template visible and linked in the same place, which is not the case when you use templater templates. Up until now, the only thing you can use this templates for was for creating new notes from that template. You trigger a command, select the form to use, fill it and the template is used to create the note.</p> <p>But I find myself many times defining a very simple for for easier the insertion of certain data in an existing note. However, for that I was forced to first create the form then create a templater template that uses that form (whith all the boilerplate it entails) and then either tell templater to create a command for that template or use the insert template from templater command. When I saw how easy is to create commands that insert text in the current note I thought it was a no brainer to not take advantage of that with the form templates.</p> <p>So that is the little but big improvement in this release. You can now use the form templates to insert text in the current note at the cursor position.</p> <p>To give an example, I have a very simple form for inserting an external link. While the experience of doing this in the Obsidian desktop app is fine, it is a bit tedious to do on mobile.</p> <p>My form looks as simple as this: </p> <p>And the template is also very simple, just:</p> <pre><code>[{{title}}]({{url}})\n</code></pre> <p>Now, I can trigger a command that will insert the template in the current note at the cursor position after filling and submitting the form.</p> <p>Hope you find this useful. I'm already using it a lot.</p>"},{"location":"blog/2024/06/22/release-notes-for-1470-and-a-statement-of-intent/","title":"Release notes for 1.47.0 and a statement of intent","text":""},{"location":"blog/2024/06/22/release-notes-for-1470-and-a-statement-of-intent/#release-notes-for-1470","title":"Release notes for 1.47.0","text":"<p>This is mostly a technical release that also includes some minor improvements.</p> <p>The technical part of it is that now the fields of the form are rendered using svelte rather than manually calling DOM manipulation methods or the obsidian <code>Setting</code> class. I made this because it simplifies the creation of the view, it will be more maintainable, but the most important reason is that it will make much much easier to implement functionalities that require atomic re-renders of the form. The most important and requested feature this will enable is the ability to have dynamic fields that depend on the value of other fields. This is not implemented yet, but it will be much easier to do now and I will start working on it soon.</p> <p>For the minor improvements, I added some more color to the form fields, so now the stars that indicate required fields are colorful.</p> <p></p> <p>I also improved the error messages when submitting a form with errors. Now the error message appears below the field in red color:</p> <p></p> <p>Also related to errors, the notifications that appear when submitting a form with errors are now grouped in a single notification containing all the errors:</p> <p></p>"},{"location":"blog/2024/06/22/release-notes-for-1470-and-a-statement-of-intent/#statement-of-intent","title":"Statement of intent","text":"<p>When I started this project, I had not much experience with Obsidian and absolute no experience with Obsidian plugin development. Also, my initial idea was to create a very simple plugin, basically something wrapping some basic existing Obsidian functionality and glueing it with some other tools I like to use (templater mainly) while making the process streamlined and more user friendly. Since then, the plugin has gained a lot of popularity, it has some thousand of installs, making it my most popular project by far. Coming from a web development background, I was imposing myself some limitations that I learned that do not make any sense in Obsidian. For example, at first I was very worried about the bundle size of the plugin (which is still very small) and I was trying to avoid using external libraries as much as possible. However, some of the most popular plugins weight several MBs and nobody seems to care. Also, many plugins diverge significantly from the Obsidian default appearance, and that is not a problem at all. What does that mean for modal form? That I will try to build better functionalities, always trying to keep the plugin simple and focused, but I will no longer limit myself to what Obsidian offers out of the box, and I will not be afraid of using external libraries if they make sense.</p> <p>Hope you like the direction I'm taking with the plugin. I'm very excited about the future of it.</p>"},{"location":"blog/2024/07/02/release-notes-for-1480/","title":"Release notes for 1.48.0","text":"<p>This is a very exciting release for me, because it includes one of the features that I have been wanting to implement for a long time, and also one of the most requested features. But it also includes some minor improvements, so let's take those first:</p> <ul> <li>The placeholder of the label is set by default to the name of the field. This will make it easier for people to understand that the default label value is the name of the field. </li> </ul> <p>Now the big feature:</p>"},{"location":"blog/2024/07/02/release-notes-for-1480/#conditional-fields","title":"Conditional fields","text":"<p>As with every new feature, I like to start small, so this first version is very simple. It just settles the basic foundation and works only with the most basic field types. This will allow me to gather feedback and improve it in the next releases after making sure that the basic functionality is working as expected.</p> <p>In this first approach there are not many safeguards either, so you can end up in forms that don't show any field, for example because of fields that are excluding each other. I don't think this is going to be a big problem in practice, but I will be monitoring the feedback to see if it is necessary to add some kind of validation, or at least some kind of warning. The reason I am not adding it any limitations in this first version is because flexibility: forms can be called with parameters to omit fields, default values, etc. and I don't want to limit that flexibility.</p> <p>Here are some screenshots of the feature in action.</p> <p>Form builder:  </p> <p>Form in preview mode with the condition met  with the condition not met </p> <p>This first iteration is purely visual: just because a field is hidden it does not mean that, if it has a value, is not going to be included in the result. If you fill a field, and then do something that makes it hidden, the value will still be included in the result. I think in practice most people just needs a way to start with several fields hidden, and then show them based on the value of other fields, so I think this is a good first approach.</p> <p>The wording of the feature is not final, I'm not very satisfied with the current wording, so I'm open to suggestions. I hope you like it, that it does not introduce too many inconveniences and that it is useful to you.</p> <p>Please let me know your thoughts and suggestions.</p>"},{"location":"blog/2024/09/12/release-notes-for-1510/","title":"Release notes for 1.51.0","text":""},{"location":"blog/2024/09/12/release-notes-for-1510/#hidden-fields","title":"Hidden fields","text":"<p>This release introduces the concept of hidden fields. The intended usage of this feature is to provide values to the form that are not visible to the user. This has some applications such as:</p> <ul> <li>providing variables to the form-runtime that your dataview functions can use</li> <li>having certain fields deactivated using the conditional without any user interaction</li> <li>having certain values be part of the generated result, and used in the templates</li> </ul> <p>I bet the community will be able to figure out some other interesting use-cases. The reason I like this approach to much is a) because it is a web standard (this is common practice to communicate between backend and frontend in forms) and b) it plays nicely with all the existing form mechanisms without having to complicate the logic at all: formatting the output, reading the value from dataview functions, conditional rendering other fields, etc.</p> <p>Hope you like it and find it useful.</p>"},{"location":"blog/2024/09/29/release-notes-for-1520/","title":"Release notes for 1.52.0","text":""},{"location":"blog/2024/09/29/release-notes-for-1520/#markdown-block","title":"Markdown block","text":"<p>This release introduces a new input, the \"markdown block\". Just like the existing \"document block\" this is not a real input, but more a building block for richer forms. The definition is expected to contain a function body returning a markdown string. This markdown string will then be rendered into the form and the user filling it will be able to see it.</p> <p>To illustrate with an example, imagine a simple form with a single text input, we can define a markdown block with this content:</p> <pre><code>return `# hello\n- line 1\n- ${form.text}\n- ![[image.png]]`\n</code></pre> <p>Have you noticed the image syntax? Yes, images are supported too. This is how it looks once rendered: </p>"},{"location":"blog/2024/09/29/release-notes-for-1520/#updates-to-the-existing-document-block","title":"Updates to the existing document block","text":"<p>Both Markdown block and document block now have access to the dataview API (along with the form data itself). This allows to build much complex and data packed information panels. To access the dataview API, you do normally just like in any other place using a special variable named <code>dv</code>. For example, and continuing with the markdown example, we could render a list of all the people (in markdown) using dataview like this:</p> <pre><code>return dv.markdownList(dv.pages('#person').map(x =&gt; x.file.name))\n</code></pre> <p>That will render something like this: </p>"},{"location":"blog/2024/12/09/release-notes-for-1530/","title":"Release notes for 1.53.0","text":""},{"location":"blog/2024/12/09/release-notes-for-1530/#introducing-image-input","title":"Introducing Image Input","text":"<p>This release introduces a brand new input type: the image input! This new component allows you to upload images directly through your forms, automatically saving them to your vault. I'm particularly excited about this new feature because I already have a lot of usecases for it on my daily life (I like to keep a record of the restaurants I visit and the meals I eat there). The possibilities it opens are big and I'm really excited about seeing what new and more visual experiences you can create using it. I also think that having a specialized way of adding images to your notes/templates is better than the obsidian way in a lot of situations.</p>"},{"location":"blog/2024/12/09/release-notes-for-1530/#whats-new","title":"What's New","text":"<p>The image input is a powerful new addition to our form inputs family that lets you:</p> <ul> <li>Save images directly to your vault</li> <li>Preview the image</li> <li>Atomically define where each image will be saved for each input</li> <li>Use templates for file naming with date/time placeholders</li> </ul> <p>Here's how it looks in action: </p> <p>There is also a new helper in the FormResult object that simplifies the creation of markdown links to the image. For example, if you have a field called <code>image</code> in your form result, you can use it like this in your templates:</p> <pre><code>&lt;% result.image.link %&gt;\n</code></pre>"},{"location":"blog/2024/12/09/release-notes-for-1530/#using-the-image-input","title":"Using the Image Input","text":"<p>Adding an image input to your form is very straightforward using the FormBuilder. Here's an example screenshot: </p> <p>The configuration has two main settings:</p> <ul> <li><code>filenameTemplate</code>: Define how your files will be named. You can use placeholders like <code>{{date}}</code>, <code>{{time}}</code>, or <code>{{datetime}}</code>.</li> <li><code>saveLocation</code>: Specify where in your vault the image will be saved. Don't worry if the folder doesn't exist - it will be created automatically!</li> </ul>"},{"location":"blog/2024/12/09/release-notes-for-1530/#drawbacks","title":"Drawbacks","text":"<p>As with every first version of every new feature, there is an important drawback: the image input is eager to save the image. This means that the image will be saved as soon as you select it, even if the form is not submitted, or if you pick a different image. This is a tradeoff that simplified the implementation and makes some scenarios simpler , like using the image in a markdown block or in other dynamic inputs.</p> <p>It is also worth mentioning that the value you get in the form result is not a TFile directly but a wrapped TFile object. This is because a lot of places assume it is safe to just serialize the form results to JSON, which is not the case for the TFile object. The wrapped TFile object has direct access to the most essential properties of the file, like <code>path</code>, <code>name</code>, <code>basename</code>, and <code>extension</code>. The wrapped TFile is also available through the <code>TFile</code> property in the wrapping class <code>FileProxy</code>.</p> <p>Here is an example of how you can use the wrapped TFile object:</p> <pre><code>const result = await MF.openForm(\"my-form\");\n// assuming your image input is called \"image\"\nconst file = result.image.value.TFile;\n- ctime: &lt;% file.stat.ctime %&gt;\n- mtime: &lt;% file.stat.mtime %&gt;\n- size: &lt;% file.stat.size %&gt;\n</code></pre>"},{"location":"blog/2024/12/19/release-notes-for-1560/","title":"Release notes for 1.56.0","text":""},{"location":"blog/2024/12/19/release-notes-for-1560/#templates-now-support-templater-syntax","title":"Templates now support Templater syntax","text":"<p>Modal Form 1.56.0 enhances its templates feature with Templater support! I'm particularly excited about this integration because, with a little addition we are greatly improving the usability of this plugin, but also Templater. Now binding a particular form to a complex template is easier than ever, knowing the fields available in the template also becomes a lot easier and I think the overall experience is greatly improved.</p> <p></p>"},{"location":"blog/2024/12/19/release-notes-for-1560/#whats-new","title":"What's New","text":"<p>The Templater integration adds the following capabilities to form templates:</p> <ul> <li>Use Templater syntax (<code>&lt;% %&gt;</code>) inside form templates</li> <li>Process dates, files, and system information through Templater</li> <li>Automatic processing of Templater syntax after form variables are replaced</li> </ul> <p>Here's a little example combining both syntaxes:</p> <pre><code>---\ncreated: &lt;% tp.date.now() %&gt;\n---\n\nDear {{name}},\n\nMeeting scheduled for &lt;% tp.date.now(\"MMMM Do, YYYY\") %&gt;\nLocation: {{location}}\n\nBest regards,\n{{signature}}\n</code></pre>"},{"location":"blog/2024/12/19/release-notes-for-1560/#how-it-works","title":"How it Works","text":"<p>The template processing now happens in two stages:</p> <ol> <li>First, Modal Form replaces all form variables (the <code>{{variable}}</code> syntax)</li> <li>Then, if Templater is available, it processes any Templater syntax in the resulting text</li> </ol>"},{"location":"blog/2024/12/19/release-notes-for-1560/#retry-functionality","title":"Retry Functionality","text":"<p>Getting templater templates right at the first try can be hard, that's why we added a retry option when templater processing part fails. If something goes wrong during templater processing , Modal Form now provides a retry modal where you can try to fix the template and try again.:</p> <p></p> <p>This makes it easier to fix any issues without losing your form data and gives you an insight on how te template is processed.</p> <p>Check out the templates documentation for more details and examples of how to use this new feature.</p>"},{"location":"blog/2024/12/12/modal-form-showcase-thread/","title":"Modal form showcase thread","text":"<p>Hello everyone.</p> <p>I've created this thread so people can share their awesome workflows using modal forms.</p> <p>A lot of times people that open feature requests mention they need such feature to complete their workflow, or that such feature will make their workflow simpler, and then they mention what their workflow is about and then blow my mind.</p> <p>I saw other plugins also have similar threads, so I decided to create this one to encourage people to share their forms and how are they using them.</p> <p>Anyone is free to provide their experiences however they want, but here are some suggestions that I think will make each post even more useful for everyone:</p> <ul> <li>Start the thread with a summary of the workflow or the problem you are solving.</li> <li>If you can, export your form as a JSON file and share it in the thread using a code block. This will make it easier for others to use your form.</li> <li>If you can, share a screenshot of your form. This will make it easier for others to understand what your form looks like and makes it a lot more engaging.</li> <li>If you are calling the form from a template, please share the template as well in another code block.</li> <li>If you are okay about including your post as part of the example vault on modal form repository, please say so, then others just looking at the plugin repository can see your example.</li> </ul> <p>And that's all. I'm very excited about seeing all the different workflows and how you use modal forms, and I hope this will be a great way to share and learn from each other.</p>"},{"location":"blog/archive/2024/","title":"2024","text":""}]}
\ No newline at end of file
+{"config":{"lang":["en"],"separator":"[\\s\\-]+","pipeline":["stopWordFilter"]},"docs":[{"location":"","title":"Home","text":""},{"location":"#obsidian-modal-form-plugin","title":"Obsidian Modal Form Plugin","text":"<p>This plugin for Obsidian allows you to define forms that can be opened from anywhere you can run JavaScript, so you can combine it with other plugins like Templater or QuickAdd.</p> <p>https://github.com/danielo515/obsidian-modal-form/assets/2270425/542974aa-c58b-4733-89ea-9c20ea11bee9</p>"},{"location":"#features","title":"Features","text":"<ul> <li>Forms open in a modal window and return you the values, so you can trigger it from:<ul> <li>Templater templates</li> <li>QuickAdd captures</li> <li>DataviewJS queries</li> <li>Many other places...</li> </ul> </li> <li>Define forms using a simple JSON format</li> <li>Create and manage a collection of forms, each identified by a unique name</li> <li>User interface for creating new forms</li> <li>Create new notes directly from the form using templates<ul> <li>Template editor has a nice UI for creating templates</li> </ul> </li> <li>Many input types<ul> <li>number</li> <li>date</li> <li>time</li> <li>slider</li> <li>toggle (true/false)</li> <li>free text</li> <li>text with autocompletion for note names (from a folder or root)</li> <li>text with autocompletion from a dataview query (requires dataview plugin)</li> <li>multiple choice input</li> <li>select from a list<ul> <li>list of fixed values</li> <li>list of notes from a folder</li> </ul> </li> </ul> </li> </ul>"},{"location":"#template-builder","title":"Template builder","text":"<p>We have a nice UI to help you creating the required templates. </p>"},{"location":"#why-this-plugin","title":"Why this plugin?","text":"<p>Obsidian is a great tool for taking notes, but it is also a nice for managing data. However, when it's time to capture structured data it doesn't offer many conveniences. Some plugins like Templater or QuickAdd alleviate this problem with templates/automation that ease the creation of notes with a predefined structure, but then you have to fill the data manually. The mentioned plugins (Templater, QuickAdd) have some little convenience inputs, but they have certain tradeoffs/problems:</p> <ul> <li>they are limited to inputting a single value at a time</li> <li>they don't have labels or detailed descriptions about the field you are filling</li> <li>you can't skip fields, you will always be prompted for all of them one by one</li> </ul> <p>All of the mentioned tools are great at their job and unleash super convenient workflows. For that reason, rather than offering an alternative, this plugin is designed as a complement to them, offering some basic building blocks that you can integrate with your existing templates and workflows.</p>"},{"location":"#friends-of-modal-form","title":"Friends of modal form","text":"<ul> <li>Templater to open modals from templates</li> <li>QuickAdd to quickly capture data from a modal</li> <li>dataview to provide values for auto-completion</li> </ul>"},{"location":"#scope-of-this-plugin","title":"Scope of this plugin","text":"<p>This plugin is intentionally narrow in scope. As mentioned in the previous section, it is designed as a building block, so you can integrate it with other plugins and workflows. The only features that I will consider adding will be ones about improving the form itself.</p>"},{"location":"#usage","title":"Usage","text":""},{"location":"#call-the-form-from-javascript","title":"Call the form from JavaScript","text":"<p>Since the main usage of this plugin is opening forms and getting back their data let's start with that. If you want to learn how to create forms, skip to the next section define a form.</p> <p>The plugin exposes an API that can be accessed from any JavaScript code that has access to the global <code>app</code> object. So, in order to get the API you can do:</p> <pre><code>const modalForm = app.plugins.plugins.modalforms.api;\n</code></pre> <p>From here you can call any of the main methods of the API, <code>openForm</code> which allows you to open a form by name and get back the data. Let's see an example:</p> <pre><code>const modalForm = app.plugins.plugins.modalforms.api;\nconst result = await modalForm.openForm(\"example-form\");\n</code></pre> <p>The result is a special type of object that contains the data of the form. It also has some convenient methods to help you process the returned data. One of them is <code>asFrontmatterString</code>, which returns the data as a string that can be used in a frontmatter block. Let's see an example using Templater:</p>"},{"location":"#usage-with-templater","title":"Usage with Templater","text":"<pre><code>---\n&lt;%*\nconst modalForm = app.plugins.plugins.modalforms.api;\nconst result = await modalForm.openForm('example-form');\ntR += result.asFrontmatterString();\n-%&gt;\n---\n</code></pre> <p>When you insert this template in a note, it will open the form, and once you submit it, it will insert the data in the note as a frontmatter block.</p>"},{"location":"#usage-with-quickadd","title":"Usage with QuickAdd","text":"<p>In order to open a form from QuickAdd capture, you need to create a capture and activate the capture format, then in the format text-area you must create a code block with the language defined as <code>js quickadd</code> and copy the code below:</p> <pre><code>```js quickadd\n    const modalForm = app.plugins.plugins.modalforms.api;\n    const result = await modalForm.openForm('example-form');\n    return result.asDataviewProperties();\n```\n</code></pre> <p>Here you have an example screenshot of how it should look like: </p>"},{"location":"#providing-default-values-when-opening-a-form","title":"Providing Default Values When Opening a Form","text":"<p>When opening a form you can provide default values for the form fields. This can be done by passing an object to the <code>openForm</code> or <code>limitedForm</code> methods as part of the <code>FormOptions</code> parameter. This object should have the same structure as the form definition, with each key corresponding to a field name and its value being the default value for that field.</p> <p>Here's an example:</p> <pre><code>const values = {\n    title: \"My Default Title\",\n    description: \"This is a default description.\",\n};\n\nconst modalForm = app.plugins.plugins.modalforms.api;\nconst result = await modalForm.openForm(\"example-form\", { values: values });\n</code></pre> <p>In this example, the form will open with the <code>title</code> field pre-filled with <code>My Default Title</code> and the <code>description</code> field pre-filled with <code>This is a default description.</code>.</p> <p>Note: If a field in the default values object does not exist in the form definition, it will be ignored.</p>"},{"location":"#formresult-methods","title":"FormResult Methods","text":"<p>When you open a form, you get back a <code>FormResult</code> object. This object contains the data of the form and some methods to help you process it. This <code>FormResult</code> object returned by the <code>openForm</code> method has several methods that can be used to process the form data. Here is a brief description of each method:</p>"},{"location":"#asfrontmatterstring","title":"asFrontmatterString()","text":"<p>This method returns the form data as a string that can be used in a frontmatter block. It formats the data in YAML syntax. Here is an example of how to use it:</p>"},{"location":"#asdataviewproperties","title":"asDataviewProperties()","text":"<p>This method returns the form data as a string of dataview properties. Each key-value pair in the form data is converted into a string in the format <code>key:: value</code>. Here is an example of how to use it:</p>"},{"location":"#getdata","title":"getData()","text":"<p>This method returns a copy of the form data. It can be used when you need to manipulate the form data without affecting the original data.</p>"},{"location":"#asstringtemplate-string","title":"asString(template: string)","text":"<p>This method returns the form data formatted as a string matching the provided template. The template is a string that can contain placeholders in the format <code>{{key}}</code>, which will be replaced with the corresponding value from the form data. Here is an example of how to use it in a templater template:</p> <pre><code>&lt;%*\nconst modalForm = app.plugins.plugins.modalforms.api;\nconst result = await modalForm.openForm('example-form');\ntR += result.asString('{{Name}} is {{age}} years old and his/her favorite food is {{favorite_meal}}. Family status: {{is_family}}');\n-%&gt;\n</code></pre>"},{"location":"#advanced-usage","title":"Advanced usage","text":"<p>For more advanced usage of the <code>FormResult</code> methods please refer to the specific documentation of FormResult here</p>"},{"location":"#define-a-form","title":"Define a form","text":""},{"location":"#create-a-new-form","title":"Create a new form","text":"<p>Creating a new form is easy, you just need to open the manage forms view, either by clicking on the ribbon icon or by using the command palette (<code>Obsidian modal form: New form</code>). Once there, click on the <code>+</code> button and you will be presented with a form to create a named form definition. The form is self-explanatory, but here are some key points you need to keep in mind:</p> <ul> <li>The name must be unique, and it will be used to identify the form when you open it from JavaScript, case-sensitive</li> <li>The title is what you will see as a header in the modal window when you open the form</li> <li>You will not be able to save the form unless all the fields are valid (which means they have a name and a type)</li> </ul> <p></p>"},{"location":"#dataview-integration","title":"Dataview integration","text":""},{"location":"#inline-forms","title":"Inline forms","text":"<p>The plugin also supports inline forms, which are forms that are defined when you call the openForm method. This is useful when you want to create a form that is only used in one place and it is simple enough. However, note the format is a bit verbose for typing it manually and it is error-prone, so unless it is a very small form, you will most likely prefer to use a named form.</p> <p>Here is an example of how to use it:</p> <pre><code>const modalForm = app.plugins.plugins.modalforms.api;\nconst result = await modalForm.openForm({\n    title: \"Example form\",\n    fields: [\n        {\n            name: \"name\",\n            label: \"Name\",\n            description: \"Your name\",\n            input: { type: \"text\" },\n        },\n        {\n            name: \"age\",\n            label: \"Age\",\n            description: \"Your age\",\n            input: { type: \"number\" },\n        },\n        {\n            name: \"favorite_meal\",\n            label: \"Favorite meal\",\n            description: \"Your favorite meal\",\n            input: { type: \"text\" },\n        },\n        {\n            name: \"is_family\",\n            label: \"Is family\",\n            type: \"toggle\",\n            description: \"Are you family?\",\n            required: true,\n            input: { type: \"toggle\" },\n        },\n    ],\n});\n</code></pre> <p>You can make it smaller by removing some of the optional fields like description or label, but I really encourage you to define them all.</p>"},{"location":"#tips-and-tricks","title":"Tips and tricks","text":"<ul> <li>How to make opening the forms more convenient</li> </ul>"},{"location":"#installing-the-plugin","title":"Installing the plugin","text":"<p>You can install the plugin directly from the Obsidian plugin store or through BRAT</p>"},{"location":"#installing-with-brat","title":"Installing with BRAT","text":"<ol> <li>Install the BRAT plugin (GitHub page) and enable it.</li> <li>Open the command palette and run the command BRAT: Add a beta plugin for testing.</li> <li>Enter <code>https://github.com/danielo515/obsidian-modal-form</code> into the modal and press the Add Plugin button.</li> <li>Return to the settings and navigate to the Community plugins tab.</li> <li>Enable the plugin.</li> </ol>"},{"location":"#manually-installing-the-plugin","title":"Manually installing the plugin","text":"<ul> <li>Copy over <code>main.js</code>, <code>styles.css</code>, <code>manifest.json</code> to your vault <code>VaultFolder/.obsidian/plugins/modalForm/</code>.</li> </ul>"},{"location":"#how-to-develop","title":"How to develop","text":"<ul> <li>Clone this repo.</li> <li>Make sure your NodeJS is at least v16 (<code>node --version</code>).</li> <li><code>npm i</code> or <code>yarn</code> to install dependencies.</li> <li><code>npm run dev</code> to start compilation in watch mode.</li> </ul>"},{"location":"#releasing-new-releases","title":"Releasing new releases","text":"<ul> <li>run <code>npm version patch</code>, <code>npm version minor</code>, or <code>npm version major</code> after updating <code>minAppVersion</code> manually in <code>manifest.json</code>.</li> <li>Upload the files <code>manifest.json</code>, <code>main.js</code>, <code>styles.css</code> as binary attachments. Note: The manifest.json file must be in two places, first the root path of your repository and also in the release.</li> <li>Publish the release.</li> </ul> <p>The command <code>npm version whatever</code> will bump version in <code>manifest.json</code> and <code>package.json</code>, and add the entry for the new version to <code>versions.json</code></p>"},{"location":"#publish-docs","title":"Publish docs","text":"<p>We use mkdocs to generate the documentation. To publish the docs, run:</p> <pre><code>./build-docs.sh\n</code></pre>"},{"location":"ResultValue/","title":"ResultValue","text":"<p>This class is a helper wrapper for values coming from a form Result. It provides a safer and convenient interface to render the contained value in various formats. The main purpose is to avoid the need to check for null or undefined values while having a convenient interface to print the value in a template.</p>"},{"location":"ResultValue/#usage","title":"Usage","text":"<p>All the following examples assume that the form has been opened with the following templater code:</p> <pre><code>&lt;%* const result = await forms.openForm('myForm'); %&gt;\n</code></pre>"},{"location":"ResultValue/#renderprinting-as-string","title":"Render/printing as string","text":"<p>By default, the value is rendered as a string. If the value is null or undefined, an empty string is returned. You don't need to call or do anything special to render the value as a string, just use it as if it was a string.</p> <pre><code>&lt;% result.getValue('firstField') %&gt;\n</code></pre> <p>if the value of the field is \"Hello World\", the above code will print \"Hello World\" in the resulting note. However, if the value is null or undefined, nothing will be printed.</p>"},{"location":"ResultValue/#renderprinting-as-bullet-list","title":"Render/printing as bullet list","text":"<p>You can render any value as a bullet list by using the <code>toBulletList()</code> method. If the value is an array, each element of the array will be printed as a bullet point. If the value is a primitive, like a number or a string, it will be printed as a single bullet point. If the value is null or undefined, an empty string is printed.</p> <pre><code>&lt;% result.getValue('listField').toBulletList() %&gt;\n</code></pre> <p>You can also use a shorthand for this method by using the <code>bullets</code> property:</p> <pre><code>&lt;% result.getValue('listField').bullets %&gt;\n</code></pre> <p>The above code is equivalent to the previous one.</p> <p>If the value of the field is <code>[\"Hello\", \"World\"]</code>, the above code will print:</p> <pre><code>- Hello\n- World\n</code></pre>"},{"location":"ResultValue/#renderprinting-as-dataview-field","title":"Render/printing as dataview field","text":"<p>You can render any value as a dataview field by using the <code>toDataviewField()</code> method or the shorthand <code>toDv()</code> alias.</p> <p>List values are rendered as a dataview list field, while primitive values are just rendered as a dataview field.</p> <pre><code>&lt;% result.getValue('listField').toDataviewField() %&gt;\nOr alias:\n&lt;% result.getValue('listField').toDv() %&gt;\n</code></pre> <p>if the value of the field is <code>[\"Hello\", \"World\"]</code>, the above code will print:</p> <pre><code>[listField:: \"Hello\", \"World\"]\n</code></pre> <p>If the value were a primitive, like the string \"Hello World\", the above code would print:</p> <pre><code>[listField:: Hello World]\n</code></pre>"},{"location":"ResultValue/#mapfn-value-any-any-resultvalue-method","title":"<code>map(fn: (value: any) =&gt; any): ResultValue</code> method","text":"<p>The map method is a powerful one that allows you to transform the value contained in the ResultValue object without extracting it, allowing you to chain multiple transformations.</p> <pre><code>&lt;% result.getValue('listField').map((value) =&gt; value.toUpperCase()).bullets %&gt;\n</code></pre> <p>The above code will print the list field as a bullet list, but all the values will be uppercased.</p> <p>The map method takes a function that takes the value and returns a new value. It can be used when none of the provided printing are enough for your use case, or when one of them is almost what you need but you need to transform the value a bit more.</p>"},{"location":"ResultValue/#trimmedlowerupper-shortcuts","title":"<code>trimmed</code>,<code>lower</code>,<code>upper</code> shortcuts","text":"<p>The ResultValue class provides some shortcuts to common transformations of the value. They are:</p> <ul> <li><code>trimmed</code>: Trims the value, removing any leading or trailing whitespace.</li> <li><code>lower</code>: Converts the value to lowercase.</li> <li><code>upper</code>: Converts the value to uppercase.</li> </ul> <p>All of these shortcuts return a new ResultValue object, so you can chain them with other methods.</p> <pre><code>&lt;% result.getValue('listField').trimmed.upper.bullets %&gt;\n</code></pre> <p>The above code will print the list field as a bullet list, but all the values will be uppercased and trimmed. You can chain as many or as little as you want. The most common use is probably just to use one of them, like <code>trimmed</code> or <code>upper</code>.</p> <pre><code>&lt;% result.getValue('myField').trimmed %&gt;\n</code></pre> <p>All of this shortcuts are able to handle single values and lists, so you can use them with any value.</p>"},{"location":"ResultValue/#link-method","title":"<code>link</code> method","text":"<p>The <code>link</code> method is a convenience method to render the value as a markdown link. If the value is a string, it will be rendered as a markdown link. If the value is a FileProxy (right now just used for images), it will be rendered as an embedded link. Any other type of value will be rendered as an empty string.</p> <pre><code>&lt;% result.getValue('myField').link %&gt;\n</code></pre> <p>You can also use the shorthand way of accessing values directly from the form result object, like <code>result.myField.link</code>.</p> <p>Take a look at the example vault to see how it is used.</p>"},{"location":"advanced-examples/","title":"Advanced usage examples","text":"<p>In this section of the docs you will find some advanced usage examples of modal-form-plugin</p>"},{"location":"advanced-examples/#nesting-form-calls","title":"Nesting form calls","text":""},{"location":"advanced-examples/#modifying-frontmatter-with-a-form","title":"Modifying frontmatter with a form","text":"<p>If you want to modify the content of a notes frontmatter with one of your existing forms, put the following snippet in a templater template, substituting the name of your form:</p> <pre><code>&lt;%*\nconst modalForm = app.plugins.plugins.modalforms.api;\n  const run = async (frontmatter) =&gt; {\n    const result = await modalForm.openForm('frontmatter', {\n      values: { ...frontmatter },\n    });\n    return result.getData();\n  };\n  //first we get the data from the form\n  const data = await run(tp.frontmatter);\n // Then we update the frontmatter with the new data\n  app.fileManager.processFrontMatter(\n    tp.config.target_file,\n    frontmatter =&gt; {\n      Object.assign(frontmatter, data);\n    },\n  );\n%&gt;\n</code></pre> <p>Please be aware that this is not atomic, so if if something edits the frontmatter while you are editing it within the form, the form values will not reflect this change and you may be overwriting some changes. Although this is unlikely to happen, it is better to be aware of it.</p> <p>The values the form understand and that are pressent in the frontmatter, will be populated with the values on the frontmatter. Then, when you submit the form, the new values will overwrite the old ones, leaving the rest untouched.</p>"},{"location":"advanced-examples/#making-calling-forms-more-convenient","title":"Making calling forms more convenient","text":"<p>If you are using templater, you can make calling forms more convenient by using the following snippet:</p> <pre><code>const modalForm = app.plugins.plugins.modalforms.api;\nmodule.exports = (formName, options) =&gt; modalForm.openForm(formName, options);\n</code></pre> <p>If you save this snippet as <code>openForm.js</code> in your templater snippets folder, then you can then call it like this from templater:</p> <pre><code>&lt;%*\nconst result = await tp.user.openForm('example-form', { values: { size: 'large' }});\n%&gt;\n</code></pre>"},{"location":"advanced-examples/#exclude-subfolders-when-selecting-notes-from-a-folder","title":"Exclude subfolders when selecting notes from a folder","text":"<p>Instead of using the <code>note</code> type or the <code>note</code> source (in case of multi-select) in your form, which doesn't support exclusions yet, we will use <code>dataview</code> (either type or as a multi-select source) to get the notes we want. Then use the following query to exclude subfolders:</p> <pre><code>dv.pages('\"Data\" AND -\"Data/Nested\"').file.name;\n</code></pre> <p>Here <code>Data</code> is the folder we want to get notes from and <code>Data/Nested</code> is the subfolder we want to exclude. Please keep in mind that <code>dataview</code> is very sensitive to spaces and quotes. Removing the nested <code>\"</code> will not work, or adding a space after the <code>-</code> will not work either.</p>"},{"location":"advanced-examples/#adding-additional-items-to-a-dataview-input","title":"Adding additional items to a Dataview Input","text":"<p>The <code>dataview</code> field it is just some expression that gets evaluated, and the values are what are shown in the input form. It can be a single <code>dataview</code> command, or it can be more things, like concatenation of results like this:</p> <pre><code>['1','2', ...dv.pages('#programming').title]\n</code></pre> <p>Which will look like this in the form:</p> <p></p> <p>You can take advantage of the preview to experiment a bit with what you will get in the input</p> <p></p>"},{"location":"changelog/","title":"Changelog","text":""},{"location":"changelog/#1570-2024-12-20","title":"1.57.0 (2024-12-20)","text":""},{"location":"changelog/#features","title":"Features","text":"<ul> <li>parser: add support for parsing transformations (2dbe84c)</li> <li>template: execute transformations when applying templates (7552a2a)</li> </ul>"},{"location":"changelog/#bug-fixes","title":"Bug Fixes","text":"<ul> <li>import forms not working (e9c64c2)</li> </ul>"},{"location":"changelog/#1560-2024-12-19","title":"1.56.0 (2024-12-19)","text":""},{"location":"changelog/#features_1","title":"Features","text":"<ul> <li>core: template service to use any available template engine to post-process templates (a3f9d4e)</li> <li>templates: ask templater to run on form template insertion (2a10a25)</li> <li>templates: offer retry on templater errors (64dae86)</li> <li>templates: post-process templates using templater (ea01cd9)</li> </ul>"},{"location":"changelog/#1550-2024-12-12","title":"1.55.0 (2024-12-12)","text":""},{"location":"changelog/#features_2","title":"Features","text":"<ul> <li>input: you can define a parent folder on the folder input (d208648)</li> </ul>"},{"location":"changelog/#bug-fixes_1","title":"Bug Fixes","text":"<ul> <li>remove deprecated usages (96aed30)</li> </ul>"},{"location":"changelog/#1540-2024-12-11","title":"1.54.0 (2024-12-11)","text":""},{"location":"changelog/#features_3","title":"Features","text":"<ul> <li>builder: File input builder (48b62af)</li> <li>input: file input schema and rendering (b4682ff)</li> </ul>"},{"location":"changelog/#1530-2024-12-09","title":"1.53.0 (2024-12-09)","text":""},{"location":"changelog/#features_4","title":"Features","text":"<ul> <li>input: added Image input type (cfc0cad)</li> </ul>"},{"location":"changelog/#1520-2024-09-29","title":"1.52.0 (2024-09-29)","text":""},{"location":"changelog/#features_5","title":"Features","text":"<ul> <li>form-runtime: markdown block input (567d391)</li> </ul>"},{"location":"changelog/#1510-2024-09-13","title":"1.51.0 (2024-09-13)","text":""},{"location":"changelog/#features_6","title":"Features","text":"<ul> <li>create an example vault (6c1f7c8)</li> <li>form-builder: add ability to hide fields to the UI (1af3b2d)</li> <li>form-engine: basic inputs can be hidden (6b5d17f)</li> </ul>"},{"location":"changelog/#1500-2024-07-10","title":"1.50.0 (2024-07-10)","text":""},{"location":"changelog/#features_7","title":"Features","text":"<ul> <li>logger instance (a30a9ff)</li> </ul>"},{"location":"changelog/#bug-fixes_2","title":"Bug Fixes","text":"<ul> <li>provide a logger implementation that only shows debug messages on debug (72faa20)</li> </ul>"},{"location":"changelog/#1490-2024-07-05","title":"1.49.0 (2024-07-05)","text":""},{"location":"changelog/#features_8","title":"Features","text":"<ul> <li>runtime: allow the select to be used as condition for other  fields (0d23e0b)</li> </ul>"},{"location":"changelog/#bug-fixes_3","title":"Bug Fixes","text":"<ul> <li>builder: properly save the isSet condition (1ffe488)</li> </ul>"},{"location":"changelog/#1480-2024-07-02","title":"1.48.0 (2024-07-02)","text":""},{"location":"changelog/#features_9","title":"Features","text":"<ul> <li>conditional input form builder (5f6a9be)</li> <li>runtime: conditional fields v1 (4ab141e)</li> <li>runtime: show conditional errors in the form (83a1060)</li> </ul>"},{"location":"changelog/#bug-fixes_4","title":"Bug Fixes","text":"<ul> <li>ConditionInput finally works as expected (c5d5fff)</li> </ul>"},{"location":"changelog/#1470-2024-06-22","title":"1.47.0 (2024-06-22)","text":""},{"location":"changelog/#features_10","title":"Features","text":"<ul> <li>group error messages (e0e9423)</li> <li>remove completely the old way of rendering fields (801d331)</li> <li>runtime: svelte versions of DocumentBlock and InputNote (968d230)</li> </ul>"},{"location":"changelog/#bug-fixes_5","title":"Bug Fixes","text":"<ul> <li>runtime: input tag in svelte (879aba9)</li> <li>runtime: svelte wrappers for obsidian settings (37f5236)</li> </ul>"},{"location":"changelog/#1460-2024-06-17","title":"1.46.0 (2024-06-17)","text":""},{"location":"changelog/#features_11","title":"Features","text":"<ul> <li>util: insert a form template into current note command (d60fe82)</li> </ul>"},{"location":"changelog/#bug-fixes_6","title":"Bug Fixes","text":"<ul> <li>templater: remove empty lines (eda92a2)</li> </ul>"},{"location":"changelog/#1452-2024-06-10","title":"1.45.2 (2024-06-10)","text":""},{"location":"changelog/#bug-fixes_7","title":"Bug Fixes","text":"<ul> <li>runtime: better weights in file suggestions  (aac26d1), closes #272</li> </ul>"},{"location":"changelog/#1451-2024-06-04","title":"1.45.1 (2024-06-04)","text":""},{"location":"changelog/#bug-fixes_8","title":"Bug Fixes","text":"<ul> <li>templater: flex wrap (4aed840)</li> </ul>"},{"location":"changelog/#1450-2024-06-04","title":"1.45.0 (2024-06-04)","text":""},{"location":"changelog/#features_12","title":"Features","text":"<ul> <li>templater: customize result name in template builder (16a2297)</li> <li>templater: easily build template body (b705136)</li> </ul>"},{"location":"changelog/#1441-2024-05-31","title":"1.44.1 (2024-05-31)","text":""},{"location":"changelog/#bug-fixes_9","title":"Bug Fixes","text":"<ul> <li>show title in the template builder (012901d)</li> </ul>"},{"location":"changelog/#1440-2024-05-30","title":"1.44.0 (2024-05-30)","text":""},{"location":"changelog/#features_13","title":"Features","text":"<ul> <li>more customizations in the generated template (6db7d29)</li> </ul>"},{"location":"changelog/#bug-fixes_10","title":"Bug Fixes","text":"<ul> <li>easy toggle all for fields to include in frontmatter (8bf4fb4)</li> </ul>"},{"location":"changelog/#1430-2024-05-30","title":"1.43.0 (2024-05-30)","text":""},{"location":"changelog/#features_14","title":"Features","text":"<ul> <li>ability to open template builder form UI (c6663ff)</li> <li>add a view for template builder (f32ebfb)</li> <li>copy to clipboard and better format (e3e3249)</li> <li>open TemplateBuilder in a modal (e376cd0)</li> <li>std: updateFirst for Array (e6f28e1)</li> </ul>"},{"location":"changelog/#1421-2024-05-14","title":"1.42.1 (2024-05-14)","text":""},{"location":"changelog/#bug-fixes_11","title":"Bug Fixes","text":"<ul> <li>set initial value of fixed-source select fields, if provided (8864226)</li> </ul>"},{"location":"changelog/#1420-2024-05-13","title":"1.42.0 (2024-05-13)","text":""},{"location":"changelog/#features_15","title":"Features","text":"<ul> <li>cancel esc button for cancel the form (ea350bf)</li> </ul>"},{"location":"changelog/#bug-fixes_12","title":"Bug Fixes","text":"<ul> <li>formEngine: gracefully handle the close of the form (a398882)</li> </ul>"},{"location":"changelog/#1410-2024-05-10","title":"1.41.0 (2024-05-10)","text":""},{"location":"changelog/#features_16","title":"Features","text":"<ul> <li>input: dataview input can be fully async (cac23bb)</li> <li>input: document block is async (1e23a1b)</li> <li>std: make the function evaluator async and handle TE (239a4d5)</li> <li>suggesters: DataviewSuggest is now async (dae4a25)</li> <li>suggesters: make SafeDataviewQuery async (239a4d5)</li> </ul>"},{"location":"changelog/#1404-2024-04-25","title":"1.40.4 (2024-04-25)","text":""},{"location":"changelog/#bug-fixes_13","title":"Bug Fixes","text":"<ul> <li>make the editor headers stick only on big screens (4193246)</li> </ul>"},{"location":"changelog/#1403-2024-04-20","title":"1.40.3 (2024-04-20)","text":""},{"location":"changelog/#bug-fixes_14","title":"Bug Fixes","text":"<ul> <li>allow decimal inputs for number fields (b70e99a), closes #237</li> </ul>"},{"location":"changelog/#1402-2024-01-22","title":"1.40.2 (2024-01-22)","text":""},{"location":"changelog/#bug-fixes_15","title":"Bug Fixes","text":"<ul> <li>support html in the document_block (1717937)</li> </ul>"},{"location":"changelog/#1401-2024-01-21","title":"1.40.1 (2024-01-21)","text":""},{"location":"changelog/#bug-fixes_16","title":"Bug Fixes","text":"<ul> <li>a bit better import UI (024b513)</li> <li>button to open import modal from form manager (1cc834e)</li> </ul>"},{"location":"changelog/#1400-2024-01-21","title":"1.40.0 (2024-01-21)","text":""},{"location":"changelog/#features_17","title":"Features","text":"<ul> <li>API: expose some utils (eb54365)</li> <li>import form modal (a844983)</li> <li>import: ability to edit forms imported from JSON (6cdb104)</li> </ul>"},{"location":"changelog/#1391-2024-01-17","title":"1.39.1 (2024-01-17)","text":""},{"location":"changelog/#bug-fixes_17","title":"Bug Fixes","text":"<ul> <li>tag should allow unknown values (4dec090)</li> </ul>"},{"location":"changelog/#1390-2024-01-14","title":"1.39.0 (2024-01-14)","text":""},{"location":"changelog/#features_18","title":"Features","text":"<ul> <li>multi select notes uses the new notes input (better UI and search) (6c3e1e5)</li> </ul>"},{"location":"changelog/#1380-2024-01-13","title":"1.38.0 (2024-01-13)","text":""},{"location":"changelog/#features_19","title":"Features","text":"<ul> <li>core: enrich_tfile utility function (1cf4508)</li> <li>form: the input file is now fuzzy over path and tags. It shows a nicer UI that includes the path (38dc4b3)</li> <li>input: note suggest shows the parent folder of the note (6409ebf)</li> </ul>"},{"location":"changelog/#1370-2024-01-06","title":"1.37.0 (2024-01-06)","text":""},{"location":"changelog/#features_20","title":"Features","text":"<ul> <li>command to directly edit a form (47d4d8c)</li> </ul>"},{"location":"changelog/#1361-2024-01-06","title":"1.36.1 (2024-01-06)","text":""},{"location":"changelog/#bug-fixes_18","title":"Bug Fixes","text":"<ul> <li>form-runtime: show an asterisk when fields are required (b578ace), closes #198</li> </ul>"},{"location":"changelog/#1360-2024-01-02","title":"1.36.0 (2024-01-02)","text":""},{"location":"changelog/#features_21","title":"Features","text":"<ul> <li>allow any value in multi-select dataview (fa9da3d), closes #54</li> <li>multi-select fixed can allow unknown values (dcefe7c)</li> <li>tags input allow any value to be selected, even if it does not exist yet (1834bf5)</li> </ul>"},{"location":"changelog/#1350-2024-01-01","title":"1.35.0 (2024-01-01)","text":""},{"location":"changelog/#features_22","title":"Features","text":"<ul> <li>option to have a global shortcut to modal form (d262a0e)</li> </ul>"},{"location":"changelog/#1340-2023-12-29","title":"1.34.0 (2023-12-29)","text":""},{"location":"changelog/#features_23","title":"Features","text":"<ul> <li>dataview query preview in FormBuilder (0a5b4cd)</li> <li>real time query preview with errors (41a7dec)</li> </ul>"},{"location":"changelog/#1330-2023-12-28","title":"1.33.0 (2023-12-28)","text":""},{"location":"changelog/#features_24","title":"Features","text":"<ul> <li>dataview rendering method for FormValue (86839ce)</li> <li>FormResult is now a proxy, so you can access the contained result values safely and directly (3f4a611)</li> <li>result value helpers for better user experience (57f2c1b)</li> <li>shortcut methods for the ResultValue helper (00ba405)</li> </ul>"},{"location":"changelog/#1321-2023-12-22","title":"1.32.1 (2023-12-22)","text":""},{"location":"changelog/#bug-fixes_19","title":"Bug Fixes","text":"<ul> <li>inline help for dataview (d7e0630)</li> </ul>"},{"location":"changelog/#1320-2023-12-17","title":"1.32.0 (2023-12-17)","text":""},{"location":"changelog/#features_25","title":"Features","text":"<ul> <li>template: add support for frontmatter command in templates (059891c)</li> </ul>"},{"location":"changelog/#1310-2023-12-17","title":"1.31.0 (2023-12-17)","text":""},{"location":"changelog/#features_26","title":"Features","text":"<ul> <li>added a get method for result data fixes #129 (ddee8a8)</li> </ul>"},{"location":"changelog/#bug-fixes_20","title":"Bug Fixes","text":"<ul> <li>add aliases for Result methods fixes #122 (d6f755c)</li> </ul>"},{"location":"changelog/#1301-2023-12-16","title":"1.30.1 (2023-12-16)","text":""},{"location":"changelog/#bug-fixes_21","title":"Bug Fixes","text":"<ul> <li>creation of unique note name (b40b2c3)</li> <li>prevent chalk to be loaded in bundle (37e4508)</li> </ul>"},{"location":"changelog/#1300-2023-12-15","title":"1.30.0 (2023-12-15)","text":""},{"location":"changelog/#features_27","title":"Features","text":"<ul> <li>create new notes from forms using templates (2a5d1bc)</li> </ul>"},{"location":"changelog/#1290-2023-12-08","title":"1.29.0 (2023-12-08)","text":""},{"location":"changelog/#features_28","title":"Features","text":"<ul> <li>input: new input folder suggester (2102619), closes #148</li> </ul>"},{"location":"changelog/#1280-2023-12-07","title":"1.28.0 (2023-12-07)","text":""},{"location":"changelog/#features_29","title":"Features","text":"<ul> <li>API: example form takes options (d204786)</li> <li>core: throttle error messages (60157bd)</li> <li>document how to make more convenient opening forms (0c70eae), closes #145</li> <li>form-editor: UI to set fields as required (c77c340)</li> <li>form-runtime: the form is now reactive (ad82789)</li> <li>validation: better UI for notify errors of form (2a609ae)</li> </ul>"},{"location":"changelog/#bug-fixes_22","title":"Bug Fixes","text":"<ul> <li>add a link to the docs in the settings (704aa99), closes #58</li> <li>functional form engine (ab99b0e)</li> <li>input: multi-select refocus on enter (6f8d2ca)</li> <li>preettier invalid form view in form manager (b256a1a)</li> </ul>"},{"location":"changelog/#1271-2023-11-23","title":"1.27.1 (2023-11-23)","text":""},{"location":"changelog/#bug-fixes_23","title":"Bug Fixes","text":"<ul> <li>remove leading # in tags (556b769)</li> </ul>"},{"location":"changelog/#1270-2023-11-22","title":"1.27.0 (2023-11-22)","text":""},{"location":"changelog/#features_30","title":"Features","text":"<ul> <li>input: tag suggest input, initial version (9f0d8af), closes #118</li> </ul>"},{"location":"changelog/#1260-2023-11-07","title":"1.26.0 (2023-11-07)","text":""},{"location":"changelog/#features_31","title":"Features","text":"<ul> <li>ability to add a custom class name to the form body (28d81b9), closes #125</li> </ul>"},{"location":"changelog/#1250-2023-11-06","title":"1.25.0 (2023-11-06)","text":""},{"location":"changelog/#features_32","title":"Features","text":"<ul> <li>make the dataview input more fuzzy (1971fdc)</li> </ul>"},{"location":"changelog/#1241-2023-11-04","title":"1.24.1 (2023-11-04)","text":""},{"location":"changelog/#bug-fixes_24","title":"Bug Fixes","text":"<ul> <li>input: if folder does not exist, the form does not fail (0d5afbd), closes #90</li> </ul>"},{"location":"changelog/#1240-2023-11-03","title":"1.24.0 (2023-11-03)","text":""},{"location":"changelog/#features_33","title":"Features","text":"<ul> <li>editor: create dataview inputs (75f71f1)</li> <li>inputs: dataview can be used as source for multi-select (cd39785), closes #50</li> </ul>"},{"location":"changelog/#1230-2023-11-02","title":"1.23.0 (2023-11-02)","text":""},{"location":"changelog/#features_34","title":"Features","text":"<ul> <li>specific field/input error reporting methods (3bfd22d)</li> </ul>"},{"location":"changelog/#bug-fixes_25","title":"Bug Fixes","text":"<ul> <li>forms can not be renamed (ab2e20d), closes #108</li> <li>ManageForms view is now reactive thanks to stores (040f8f5)</li> </ul>"},{"location":"changelog/#1221-2023-10-26","title":"1.22.1 (2023-10-26)","text":""},{"location":"changelog/#bug-fixes_26","title":"Bug Fixes","text":"<ul> <li>big bundle size (e5f566e)</li> </ul>"},{"location":"changelog/#1220-2023-10-26","title":"1.22.0 (2023-10-26)","text":""},{"location":"changelog/#features_35","title":"Features","text":"<ul> <li>allow pick/omit in Result helpers (1c5bd5f), closes #101</li> </ul>"},{"location":"changelog/#bug-fixes_27","title":"Bug Fixes","text":"<ul> <li>add tests for result class and helpers (e4eea18)</li> <li>dataview list format is now correct (e4eea18)</li> </ul>"},{"location":"changelog/#1210-2023-10-25","title":"1.21.0 (2023-10-25)","text":""},{"location":"changelog/#features_36","title":"Features","text":"<ul> <li>detect invalid data on data.json (91aa99c), closes #98</li> <li>migrate between form format versions (b4e6c96), closes #92</li> </ul>"},{"location":"changelog/#bug-fixes_28","title":"Bug Fixes","text":"<ul> <li>add version to the form definition (c7fdd77)</li> <li>proper duplicate scroll (28cebd4)</li> </ul>"},{"location":"changelog/#1200-2023-10-22","title":"1.20.0 (2023-10-22)","text":""},{"location":"changelog/#features_37","title":"Features","text":"<ul> <li>Enable Ctrl+Enter form submission (#60) (7f72122)</li> </ul>"},{"location":"changelog/#1190-2023-10-22","title":"1.19.0 (2023-10-22)","text":""},{"location":"changelog/#features_38","title":"Features","text":"<ul> <li>Export form as JSON button (#29) (defc86c)</li> <li>scroll to elements on the list (f9804a7)</li> <li>scroll to new fields in the editor (ce3ece5)</li> </ul>"},{"location":"changelog/#bug-fixes_29","title":"Bug Fixes","text":"<ul> <li>accept empty option values for now (6293dad)</li> <li>ensure types in svelte at build (fbe03d3)</li> <li>pipelines install (2c9a17f)</li> <li>type check also svelte files (903b9bf)</li> <li>type narrow on svelte (c46dc40)</li> </ul>"},{"location":"changelog/#1180-2023-10-21","title":"1.18.0 (2023-10-21)","text":""},{"location":"changelog/#features_39","title":"Features","text":"<ul> <li>ability to order select options (#64) (b955726)</li> </ul>"},{"location":"changelog/#1170-2023-10-20","title":"1.17.0 (2023-10-20)","text":""},{"location":"changelog/#features_40","title":"Features","text":"<ul> <li>added tests (1230a34)</li> <li>show errors when form has any invalid field (54e9eaf)</li> </ul>"},{"location":"changelog/#1166-2023-10-19","title":"1.16.6 (2023-10-19)","text":""},{"location":"changelog/#bug-fixes_30","title":"Bug Fixes","text":"<ul> <li>remove all trace of text input suggest (68cace2)</li> </ul>"},{"location":"changelog/#1165-2023-10-19","title":"1.16.5 (2023-10-19)","text":""},{"location":"changelog/#bug-fixes_31","title":"Bug Fixes","text":"<ul> <li>separate input builder for select (e75a1f4), closes #75</li> </ul>"},{"location":"changelog/#1164-2023-10-16","title":"1.16.4 (2023-10-16)","text":""},{"location":"changelog/#bug-fixes_32","title":"Bug Fixes","text":"<ul> <li>do not close existing leafs, reuse instead (b00b6b8), closes #36</li> <li>open the main view in a new tab (b00b6b8)</li> </ul>"},{"location":"changelog/#1163-2023-10-16","title":"1.16.3 (2023-10-16)","text":""},{"location":"changelog/#bug-fixes_33","title":"Bug Fixes","text":"<ul> <li>text-area initial value (f21b783)</li> </ul>"},{"location":"changelog/#1162-2023-10-11","title":"1.16.2 (2023-10-11)","text":""},{"location":"changelog/#bug-fixes_34","title":"Bug Fixes","text":"<ul> <li>make multi-select static work (fa5987a), closes #63</li> </ul>"},{"location":"changelog/#1161-2023-10-10","title":"1.16.1 (2023-10-10)","text":""},{"location":"changelog/#bug-fixes_35","title":"Bug Fixes","text":"<ul> <li>ensure order of fixed select (62b407e), closes #61</li> </ul>"},{"location":"changelog/#1160-2023-10-03","title":"1.16.0 (2023-10-03)","text":""},{"location":"changelog/#features_41","title":"Features","text":"<ul> <li>add multi-line text area (1cf1559), closes #46</li> </ul>"},{"location":"changelog/#1150-2023-10-02","title":"1.15.0 (2023-10-02)","text":""},{"location":"changelog/#features_42","title":"Features","text":"<ul> <li>default values support for most input types (f8415a3)</li> </ul>"},{"location":"changelog/#bug-fixes_36","title":"Bug Fixes","text":"<ul> <li>do not use innerHTML (8ae7d5b)</li> </ul>"},{"location":"changelog/#1141-2023-09-29","title":"1.14.1 (2023-09-29)","text":""},{"location":"changelog/#bug-fixes_37","title":"Bug Fixes","text":"<ul> <li>properly clone elements (667ebe0), closes #51</li> <li>set a default value for inputs of type select (2c514b1), closes #45</li> </ul>"},{"location":"changelog/#1140-2023-09-15","title":"1.14.0 (2023-09-15)","text":""},{"location":"changelog/#features_43","title":"Features","text":"<ul> <li>show result preview (7425df1)</li> </ul>"},{"location":"changelog/#bug-fixes_38","title":"Bug Fixes","text":"<ul> <li>filtering in multi with uppercase (fac67ea)</li> <li>multi select was not including the values (1885834)</li> </ul>"},{"location":"changelog/#1130-2023-09-15","title":"1.13.0 (2023-09-15)","text":""},{"location":"changelog/#features_44","title":"Features","text":"<ul> <li>limitedForm api (b0acb29), closes #39</li> </ul>"},{"location":"changelog/#1121-2023-09-15","title":"1.12.1 (2023-09-15)","text":""},{"location":"changelog/#bug-fixes_39","title":"Bug Fixes","text":"<ul> <li>make sure the editor always has the right height (53f10b3), closes #38</li> </ul>"},{"location":"changelog/#1120-2023-09-15","title":"1.12.0 (2023-09-15)","text":""},{"location":"changelog/#features_45","title":"Features","text":"<ul> <li>multi select UI builder (3eff7a8)</li> <li>multi-select v1 (e3ee492)</li> </ul>"},{"location":"changelog/#bug-fixes_40","title":"Bug Fixes","text":"<ul> <li>proper colors for save and close (4c6d495)</li> <li>toggles always have a value (72cfc3e)</li> </ul>"},{"location":"changelog/#1110-2023-09-14","title":"1.11.0 (2023-09-14)","text":""},{"location":"changelog/#features_46","title":"Features","text":"<ul> <li>preview form from the editor (2d8e2d6), closes #17</li> </ul>"},{"location":"changelog/#1100-2023-09-14","title":"1.10.0 (2023-09-14)","text":""},{"location":"changelog/#features_47","title":"Features","text":"<ul> <li>show better errors (8202d37)</li> </ul>"},{"location":"changelog/#bug-fixes_41","title":"Bug Fixes","text":"<ul> <li>dataview input was not filtering (8202d37)</li> </ul>"},{"location":"changelog/#191-2023-09-14","title":"1.9.1 (2023-09-14)","text":""},{"location":"changelog/#bug-fixes_42","title":"Bug Fixes","text":"<ul> <li>release process (790d84d)</li> </ul>"},{"location":"changelog/#190-2023-09-14","title":"1.9.0 (2023-09-14)","text":""},{"location":"changelog/#features_48","title":"Features","text":"<ul> <li>keep the form header always visible (216d9b4), closes #11</li> </ul>"},{"location":"changelog/#bug-fixes_43","title":"Bug Fixes","text":"<ul> <li>release-bot (0586068)</li> </ul>"},{"location":"changelog/#180-2023-09-13","title":"1.8.0 (2023-09-13)","text":""},{"location":"changelog/#features_49","title":"Features","text":"<ul> <li>dataview input type (22b8949)</li> </ul>"},{"location":"changelog/#171-2023-09-13","title":"1.7.1 (2023-09-13)","text":""},{"location":"changelog/#bug-fixes_44","title":"Bug Fixes","text":"<ul> <li>remove deprecated usages of app (343ff57)</li> </ul>"},{"location":"changelog/#170-2023-09-12","title":"1.7.0 (2023-09-12)","text":""},{"location":"changelog/#features_50","title":"Features","text":"<ul> <li>duplicate form (7a0f1c6), closes #20</li> </ul>"},{"location":"changelog/#bug-fixes_45","title":"Bug Fixes","text":"<ul> <li>fix the versioning, I hope (7bb7d7d)</li> </ul>"},{"location":"changelog/#160-2023-09-12","title":"1.6.0 (2023-09-12)","text":""},{"location":"changelog/#features_51","title":"Features","text":"<ul> <li>allow to duplicate fields (21777e9), closes #20</li> </ul>"},{"location":"changelog/#150-2023-09-12","title":"1.5.0 (2023-09-12)","text":""},{"location":"changelog/#features_52","title":"Features","text":"<ul> <li>ability to cancel edits to a form (f90d7f0), closes #8</li> </ul>"},{"location":"changelog/#140-2023-09-11","title":"1.4.0 (2023-09-11)","text":""},{"location":"changelog/#features_53","title":"Features","text":"<ul> <li>decide where to open the forms editor/manager (bd5a957)</li> </ul>"},{"location":"changelog/#bug-fixes_46","title":"Bug Fixes","text":"<ul> <li>make field name required (2892503)</li> </ul>"},{"location":"changelog/#130-2023-09-11","title":"1.3.0 (2023-09-11)","text":""},{"location":"changelog/#features_54","title":"Features","text":"<ul> <li>ability to order fields (79517c0)</li> </ul>"},{"location":"changelog/#122-2023-09-11","title":"1.2.2 (2023-09-11)","text":""},{"location":"changelog/#bug-fixes_47","title":"Bug Fixes","text":"<ul> <li>rename the plugin to follow obsidian guidelines (2487590)</li> </ul>"},{"location":"changelog/#121-2023-09-11","title":"1.2.1 (2023-09-11)","text":""},{"location":"changelog/#bug-fixes_48","title":"Bug Fixes","text":"<ul> <li>do not include v in tag (7a54a24)</li> </ul>"},{"location":"changelog/#120-2023-09-11","title":"1.2.0 (2023-09-11)","text":""},{"location":"changelog/#features_55","title":"Features","text":"<ul> <li>complete core decoding and validation (7fc538c)</li> <li>FormEditor V1 (ce228ef)</li> <li>manage forms view (bb99d2d)</li> <li>mobile handling of the form editor (1be84bd)</li> <li>suggest folder input (3adaf07)</li> </ul>"},{"location":"changelog/#bug-fixes_49","title":"Bug Fixes","text":"<ul> <li>delete forms (70c6a77)</li> <li>icons (fca57dd)</li> </ul>"},{"location":"changelog/#110-2023-09-07","title":"1.1.0 (2023-09-07)","text":""},{"location":"changelog/#features_56","title":"Features","text":"<ul> <li>asString using template (5041673)</li> <li>real API v1 (1a8da2f)</li> <li>slider (bb9c0b5)</li> </ul>"},{"location":"changelog/#100-2023-09-06","title":"1.0.0 (2023-09-06)","text":""},{"location":"changelog/#features_57","title":"Features","text":"<ul> <li>add support for all the basic fields (991c53e)</li> <li>dataview serialization (9b38402)</li> <li>form result (2f63a90)</li> <li>initial prototype (ae1404a)</li> <li>note input with autocomplete and narrowed to specific folder (89bce4c)</li> <li>select input for notes narrowed to specific folder (89bce4c)</li> <li>select input with fixed number of elements (89bce4c)</li> <li>support numbers and text (5b27caf)</li> </ul>"},{"location":"import-forms/","title":"Importing a form","text":""},{"location":"import-forms/#importing-forms","title":"Importing Forms","text":"<p>Since release 1.40.0 it is possible to import forms from JSON. You can open the import modal from the command palette or from the forms list. The command is called <code>Import Form</code> for the surprise of no one. That will present a simple modal with a text area where you can paste the JSON. Any errors will appear next to the text area if any. Once you fix the errors you can click the <code>Import</code> button which will open the form editor with the imported form. From there you can do any changes you want and save it. </p>"},{"location":"long-list-tip/","title":"TIP: How to put a long list of values in a select without having to type them one by one","text":"<p>When you already have a long list of values that you want in a select input, instead of putting them one by one in the fixed list, you can use the <code>dataview</code> input type and just return the values as an array in the dataview query.</p> <p>For example, you can put the following in a select input with <code>dataview</code> as the source:</p> <pre><code>return [\n    'Wash the dishes',\n    'Take out the trash',\n    'Do the laundry',\n    'Mow the lawn',\n    'Feed the cat',\n    'Feed the dog',\n    'Feed the fish',\n    'Feed the birds',\n    'Feed the turtles',\n    'Feed the rabbits',\n    'Feed the turtles',]\n</code></pre> <p>And the result will be: </p> <p>Here is an screenshot of how it looks in the form builder: </p>"},{"location":"managing-results/","title":"Managing Results","text":"<p>The <code>FormResult</code> class provides methods for accessing and formatting form results.</p> <p>[!TIP] From version <code>1.33.0</code> onwards, the <code>FormResult</code> class allows accessing the values of the form fields  using directly <code>property accessors</code>, like <code>result.title</code> or <code>result.listField</code>. The property accessors are equivalent to calling the <code>get</code> method, so <code>result.title</code> is equivalent to <code>result.get('title')</code>, but it's shorter and more convenient. All the examples in this page continue to use the more explicit ways to access the values, but you can use the property accessors if you prefer.</p> <p>[!IMPORTANT] Accessing the values using <code>property accessors</code> or the <code>getValue</code> method is considered the safer and preferred way to access the values. This is because the returned values are wrapped in a <code>ResultValue</code> object that provides a safer and more convenient interface to render the values in various formats.</p>"},{"location":"managing-results/#asfrontmatterstringoptions-unknown-string","title":"<code>asFrontmatterString(options?: unknown): string</code>","text":"<p>Transforms the current data into a frontmatter string, which is expected to be enclosed in <code>---</code> when used in a markdown file. This method does not add the enclosing <code>---</code> to the string, so you can put it anywhere inside the frontmatter.</p>"},{"location":"managing-results/#parameters","title":"Parameters","text":"<ul> <li> <p><code>options</code> (optional): An options object describing what options to pick or omit.</p> <ul> <li><code>pick</code> (optional): An array of key names to pick from the data.</li> <li><code>omit</code> (optional): An array of key names to omit from the data.</li> </ul> </li> </ul>"},{"location":"managing-results/#returns","title":"Returns","text":"<ul> <li><code>string</code>: The data formatted as a frontmatter string.</li> </ul>"},{"location":"managing-results/#example","title":"Example","text":"<pre><code>const result = await form.openForm(\"my-form\");\ntR += result.asFrontmatterString({ pick: [\"title\"] });\n</code></pre>"},{"location":"managing-results/#aliases","title":"Aliases","text":"<p>this method has the following aliases:</p> <ul> <li><code>asFrontmatter</code></li> <li><code>asYaml</code></li> </ul>"},{"location":"managing-results/#asdataviewpropertiesoptions-unknown-string","title":"<code>asDataviewProperties(options?: unknown): string</code>","text":"<p>Returns the current data as a block of dataview properties.</p>"},{"location":"managing-results/#parameters_1","title":"Parameters","text":"<ul> <li> <p><code>options</code> (optional): An options object describing what options to pick or omit.</p> <ul> <li><code>pick</code> (optional): An array of key names to pick from the data.</li> <li><code>omit</code> (optional): An array of key names to omit from the data.</li> </ul> </li> </ul>"},{"location":"managing-results/#returns_1","title":"Returns","text":"<ul> <li><code>string</code>: The data formatted as a block of dataview properties.</li> </ul>"},{"location":"managing-results/#example_1","title":"Example","text":"<pre><code>const result = await form.openForm('my-form')\ntR += result.asDataviewProperties({ pick: ['title'] });`\n</code></pre>"},{"location":"managing-results/#aliases_1","title":"Aliases","text":"<p>This method has the following aliases:</p> <ul> <li><code>asDataview</code></li> <li><code>asDv</code></li> </ul>"},{"location":"managing-results/#getkey-string-mapfn-value-any-any-any","title":"<code>get(key: string, mapFn?: (value: any) =&gt; any): any</code>","text":"<p>Returns the value of the given key. If the key does not exist, returns the empty string <code>\"\"</code>. It takes an optional map function that can be used to transform the value. If the key does not exist, the map function is not called.</p>"},{"location":"managing-results/#parameters_2","title":"Parameters","text":"<ul> <li><code>key</code>: The key to get the value of.</li> <li><code>mapFn</code> (optional): A function that takes the value and returns a new value.</li> </ul>"},{"location":"managing-results/#returns_2","title":"Returns","text":"<ul> <li><code>any</code>: The value of the given key.</li> </ul>"},{"location":"managing-results/#example_2","title":"Example","text":"<pre><code>const result = await form.openForm(\"my-form\");\ntR += result.get(\"title\");\n</code></pre> <p>Or with a map function:</p> <pre><code>const result = await form.openForm(\"my-form\");\ntR += result.get(\"title\", (value) =&gt; value.toUpperCase());\n</code></pre>"},{"location":"managing-results/#getvaluekey-string-resultvalue-or-getvkey-string-resultvalue","title":"<code>getValue(key: string): ResultValue</code> or <code>getV(key: string): ResultValue</code>","text":"<p>Returns the value of the given key as a <code>ResultValue</code> object.</p>"},{"location":"managing-results/#parameters_3","title":"Parameters","text":"<ul> <li><code>key</code>: The key to get the value of.</li> </ul>"},{"location":"managing-results/#returns_3","title":"Returns","text":"<ul> <li><code>ResultValue</code>: The value of the given key as a <code>ResultValue</code> object.  If the key field doesn't exist or is empty, returns an empty <code>ResultValue</code> object. Thanks to this, you don't need to check if the field exists or is empty because the <code>ResultValue</code> object will handle it for you.</li> </ul>"},{"location":"managing-results/#example_3","title":"Example","text":"<pre><code>const result = await form.openForm(\"my-form\");\ntR += result.getValue(\"title\");\ntR += result.getValue(\"listField\").bullets;\n</code></pre> <p>Thanks to <code>property accessors</code>, you can also write the above code in a more convenient way like this:</p> <pre><code>const result = await form.openForm(\"my-form\");\ntR += result.title;\ntR += result.listField.bullets;\n</code></pre> <p>For more details and examples, see the <code>ResultValue</code> documentation.</p>"},{"location":"templates/","title":"Templates","text":"<p>Templates allow you to bind dynamic text outputs to your forms. Forms that have templates binded to them are subject to be used to create new notes or to insert them. If you use either the command to create a new note from a form or the insert form command, after the form is submitted its template will be processed using the form's values to generate the final text. After the form template is processed, if you have the templater plugin installed, the final text will be processed by templater. See the Templater Support section for more information.</p>"},{"location":"templates/#template-syntax","title":"Template Syntax","text":"<p>A template consists of plain text mixed with variables and commands:</p> <ul> <li>Variables: Wrapped in double curly braces <code>{{ }}</code>, they are replaced with form field values</li> <li>Commands: Special instructions wrapped in <code>{{# #}}</code> that control template behavior</li> </ul>"},{"location":"templates/#variables","title":"Variables","text":"<p>Variables are placeholders that get replaced with form field values. The variable name must match a field name from your form:</p> <pre><code>Hello {{name}}! Your favorite color is {{color}}.\n</code></pre>"},{"location":"templates/#basic-variable-syntax","title":"Basic Variable Syntax","text":"<ul> <li>Variable Declaration:</li> </ul> <p><code>plaintext   {{ variableName }}</code></p> <p>Example:</p> <p><code>plaintext   {{ name }}</code></p> <p>Note that spaces around the variable name are ignored, allowing for flexibility in formatting.</p> <pre><code>This is a {{variableName}}. And this is also a valid {{ variableName }}\n</code></pre>"},{"location":"templates/#variable-with-transformations","title":"Variable with Transformations","text":"<ul> <li>Transformation Syntax: You can apply transformations to a variable by using a pipe <code>|</code> followed by the transformation name.</li> </ul> <p><code>plaintext   {{ variableName | transformation }}</code></p> <p>Example:</p> <p><code>plaintext   {{ name | trim }}</code></p>"},{"location":"templates/#supported-transformations","title":"Supported Transformations","text":"<p>The following transformations can be applied to variables:</p> <ol> <li><code>upper</code>: Converts the variable's value to uppercase.</li> <li> <p>Usage:</p> <p><code>plaintext  {{ name | upper }}</code></p> </li> <li> <p><code>lower</code>: Converts the variable's value to lowercase.</p> </li> <li> <p>Usage:</p> <p><code>plaintext  {{ name | lower }}</code></p> </li> <li> <p><code>trim</code>: Removes whitespace from both ends of the variable's value.</p> </li> <li> <p>Usage:</p> <p><code>plaintext  {{ name | trim }}</code></p> </li> <li> <p><code>stringify</code>: Converts the variable's value to a JSON string.</p> </li> <li> <p>Usage:</p> <p><code>plaintext  {{ name | stringify }}</code></p> </li> </ol>"},{"location":"templates/#example-templates","title":"Example Templates","text":"<p>Here are some examples of how to use the new template syntax:</p> <ul> <li>Single Variable:</li> </ul> <p><code>plaintext   Hello, {{ name }}!</code></p> <ul> <li>Variable with Transformation:</li> </ul> <p><code>plaintext   Hello, {{ name | upper }}!</code></p> <ul> <li>Multiple Variables with Transformations:</li> </ul> <p><code>plaintext   Hello, {{ name | trim }}! You are {{ age }} years old.</code></p>"},{"location":"templates/#notes","title":"Notes","text":"<ul> <li>If an invalid transformation is specified, it will be silently ignored, and the variable will be processed without transformation.</li> <li>Spaces around the transformation operator (<code>|</code>) are ignored, allowing for flexibility in formatting:</li> </ul> <p><code>plaintext   {{ name | trim }} or {{ name|trim }} are both valid.</code></p>"},{"location":"templates/#available-commands","title":"Available Commands","text":""},{"location":"templates/#frontmatter-command","title":"Frontmatter Command","text":"<p>The frontmatter command controls which form fields appear in the YAML frontmatter section of your note:</p> <pre><code>{# frontmatter pick: title, tags #}\n</code></pre> <p>Options:</p> <ul> <li><code>pick</code>: Only include these specific fields in the frontmatter</li> <li><code>omit</code>: Exclude these fields from the frontmatter</li> </ul> <p>You can combine both options:</p> <pre><code>{# frontmatter pick: title, tags, date omit: draft #}\n</code></pre> <p>If no options are specified, all form fields will be included in the frontmatter:</p> <pre><code>{# frontmatter #}\n</code></pre>"},{"location":"templates/#templater-support","title":"Templater Support","text":"<p>If you have the Templater plugin installed, Modal Form will also process any templater syntax in your form templates. This means you can combine both the form template variables and templater syntax in your templates.</p> <p>For example:</p> <pre><code>Hello {{NAME}},\nToday is &lt;% tp.date.now() %&gt; and you are using form templates!\n</code></pre> <p>The form will first replace <code>{{NAME}}</code> with the value from your form, and then Templater will process its own syntax (like <code>&lt;% tp.date.now() %&gt;</code>) afterwards.</p> <p>Note: This feature is only available if you have the Templater plugin installed and enabled in your vault.</p>"},{"location":"templates/#example","title":"Example","text":"<p>Here's a complete template example that combines variables and frontmatter:</p> <pre><code>{# frontmatter pick: title, tags #}\n\n# {{title}}\n\nDear {{name}},\n\nThank you for your {{type}} submission about {{topic}}.\n\nBest regards,\n{{signature}}\n</code></pre>"},{"location":"blog/","title":"Blog","text":""},{"location":"blog/2024/06/15/release-notes-for-1460/","title":"Release notes for 1.46.0","text":"<p>This release contains one little change that was easy to make, but I think that it unlocks a very interesting use case for modal forms. There is a not very well documented feature in the FormEditor that allows to define a specific (and simple) template linked to that form. I implemented it partially for fun, because I love coding parsers but also partially because many times I only need very basic templating functionality and I don't want to have to write another templater template. Also, I find very appealing the idea of having both the form and the template visible and linked in the same place, which is not the case when you use templater templates. Up until now, the only thing you can use this templates for was for creating new notes from that template. You trigger a command, select the form to use, fill it and the template is used to create the note.</p> <p>But I find myself many times defining a very simple for for easier the insertion of certain data in an existing note. However, for that I was forced to first create the form then create a templater template that uses that form (whith all the boilerplate it entails) and then either tell templater to create a command for that template or use the insert template from templater command. When I saw how easy is to create commands that insert text in the current note I thought it was a no brainer to not take advantage of that with the form templates.</p> <p>So that is the little but big improvement in this release. You can now use the form templates to insert text in the current note at the cursor position.</p> <p>To give an example, I have a very simple form for inserting an external link. While the experience of doing this in the Obsidian desktop app is fine, it is a bit tedious to do on mobile.</p> <p>My form looks as simple as this: </p> <p>And the template is also very simple, just:</p> <pre><code>[{{title}}]({{url}})\n</code></pre> <p>Now, I can trigger a command that will insert the template in the current note at the cursor position after filling and submitting the form.</p> <p>Hope you find this useful. I'm already using it a lot.</p>"},{"location":"blog/2024/06/22/release-notes-for-1470-and-a-statement-of-intent/","title":"Release notes for 1.47.0 and a statement of intent","text":""},{"location":"blog/2024/06/22/release-notes-for-1470-and-a-statement-of-intent/#release-notes-for-1470","title":"Release notes for 1.47.0","text":"<p>This is mostly a technical release that also includes some minor improvements.</p> <p>The technical part of it is that now the fields of the form are rendered using svelte rather than manually calling DOM manipulation methods or the obsidian <code>Setting</code> class. I made this because it simplifies the creation of the view, it will be more maintainable, but the most important reason is that it will make much much easier to implement functionalities that require atomic re-renders of the form. The most important and requested feature this will enable is the ability to have dynamic fields that depend on the value of other fields. This is not implemented yet, but it will be much easier to do now and I will start working on it soon.</p> <p>For the minor improvements, I added some more color to the form fields, so now the stars that indicate required fields are colorful.</p> <p></p> <p>I also improved the error messages when submitting a form with errors. Now the error message appears below the field in red color:</p> <p></p> <p>Also related to errors, the notifications that appear when submitting a form with errors are now grouped in a single notification containing all the errors:</p> <p></p>"},{"location":"blog/2024/06/22/release-notes-for-1470-and-a-statement-of-intent/#statement-of-intent","title":"Statement of intent","text":"<p>When I started this project, I had not much experience with Obsidian and absolute no experience with Obsidian plugin development. Also, my initial idea was to create a very simple plugin, basically something wrapping some basic existing Obsidian functionality and glueing it with some other tools I like to use (templater mainly) while making the process streamlined and more user friendly. Since then, the plugin has gained a lot of popularity, it has some thousand of installs, making it my most popular project by far. Coming from a web development background, I was imposing myself some limitations that I learned that do not make any sense in Obsidian. For example, at first I was very worried about the bundle size of the plugin (which is still very small) and I was trying to avoid using external libraries as much as possible. However, some of the most popular plugins weight several MBs and nobody seems to care. Also, many plugins diverge significantly from the Obsidian default appearance, and that is not a problem at all. What does that mean for modal form? That I will try to build better functionalities, always trying to keep the plugin simple and focused, but I will no longer limit myself to what Obsidian offers out of the box, and I will not be afraid of using external libraries if they make sense.</p> <p>Hope you like the direction I'm taking with the plugin. I'm very excited about the future of it.</p>"},{"location":"blog/2024/07/02/release-notes-for-1480/","title":"Release notes for 1.48.0","text":"<p>This is a very exciting release for me, because it includes one of the features that I have been wanting to implement for a long time, and also one of the most requested features. But it also includes some minor improvements, so let's take those first:</p> <ul> <li>The placeholder of the label is set by default to the name of the field. This will make it easier for people to understand that the default label value is the name of the field. </li> </ul> <p>Now the big feature:</p>"},{"location":"blog/2024/07/02/release-notes-for-1480/#conditional-fields","title":"Conditional fields","text":"<p>As with every new feature, I like to start small, so this first version is very simple. It just settles the basic foundation and works only with the most basic field types. This will allow me to gather feedback and improve it in the next releases after making sure that the basic functionality is working as expected.</p> <p>In this first approach there are not many safeguards either, so you can end up in forms that don't show any field, for example because of fields that are excluding each other. I don't think this is going to be a big problem in practice, but I will be monitoring the feedback to see if it is necessary to add some kind of validation, or at least some kind of warning. The reason I am not adding it any limitations in this first version is because flexibility: forms can be called with parameters to omit fields, default values, etc. and I don't want to limit that flexibility.</p> <p>Here are some screenshots of the feature in action.</p> <p>Form builder:  </p> <p>Form in preview mode with the condition met  with the condition not met </p> <p>This first iteration is purely visual: just because a field is hidden it does not mean that, if it has a value, is not going to be included in the result. If you fill a field, and then do something that makes it hidden, the value will still be included in the result. I think in practice most people just needs a way to start with several fields hidden, and then show them based on the value of other fields, so I think this is a good first approach.</p> <p>The wording of the feature is not final, I'm not very satisfied with the current wording, so I'm open to suggestions. I hope you like it, that it does not introduce too many inconveniences and that it is useful to you.</p> <p>Please let me know your thoughts and suggestions.</p>"},{"location":"blog/2024/09/12/release-notes-for-1510/","title":"Release notes for 1.51.0","text":""},{"location":"blog/2024/09/12/release-notes-for-1510/#hidden-fields","title":"Hidden fields","text":"<p>This release introduces the concept of hidden fields. The intended usage of this feature is to provide values to the form that are not visible to the user. This has some applications such as:</p> <ul> <li>providing variables to the form-runtime that your dataview functions can use</li> <li>having certain fields deactivated using the conditional without any user interaction</li> <li>having certain values be part of the generated result, and used in the templates</li> </ul> <p>I bet the community will be able to figure out some other interesting use-cases. The reason I like this approach to much is a) because it is a web standard (this is common practice to communicate between backend and frontend in forms) and b) it plays nicely with all the existing form mechanisms without having to complicate the logic at all: formatting the output, reading the value from dataview functions, conditional rendering other fields, etc.</p> <p>Hope you like it and find it useful.</p>"},{"location":"blog/2024/09/29/release-notes-for-1520/","title":"Release notes for 1.52.0","text":""},{"location":"blog/2024/09/29/release-notes-for-1520/#markdown-block","title":"Markdown block","text":"<p>This release introduces a new input, the \"markdown block\". Just like the existing \"document block\" this is not a real input, but more a building block for richer forms. The definition is expected to contain a function body returning a markdown string. This markdown string will then be rendered into the form and the user filling it will be able to see it.</p> <p>To illustrate with an example, imagine a simple form with a single text input, we can define a markdown block with this content:</p> <pre><code>return `# hello\n- line 1\n- ${form.text}\n- ![[image.png]]`\n</code></pre> <p>Have you noticed the image syntax? Yes, images are supported too. This is how it looks once rendered: </p>"},{"location":"blog/2024/09/29/release-notes-for-1520/#updates-to-the-existing-document-block","title":"Updates to the existing document block","text":"<p>Both Markdown block and document block now have access to the dataview API (along with the form data itself). This allows to build much complex and data packed information panels. To access the dataview API, you do normally just like in any other place using a special variable named <code>dv</code>. For example, and continuing with the markdown example, we could render a list of all the people (in markdown) using dataview like this:</p> <pre><code>return dv.markdownList(dv.pages('#person').map(x =&gt; x.file.name))\n</code></pre> <p>That will render something like this: </p>"},{"location":"blog/2024/12/09/release-notes-for-1530/","title":"Release notes for 1.53.0","text":""},{"location":"blog/2024/12/09/release-notes-for-1530/#introducing-image-input","title":"Introducing Image Input","text":"<p>This release introduces a brand new input type: the image input! This new component allows you to upload images directly through your forms, automatically saving them to your vault. I'm particularly excited about this new feature because I already have a lot of usecases for it on my daily life (I like to keep a record of the restaurants I visit and the meals I eat there). The possibilities it opens are big and I'm really excited about seeing what new and more visual experiences you can create using it. I also think that having a specialized way of adding images to your notes/templates is better than the obsidian way in a lot of situations.</p>"},{"location":"blog/2024/12/09/release-notes-for-1530/#whats-new","title":"What's New","text":"<p>The image input is a powerful new addition to our form inputs family that lets you:</p> <ul> <li>Save images directly to your vault</li> <li>Preview the image</li> <li>Atomically define where each image will be saved for each input</li> <li>Use templates for file naming with date/time placeholders</li> </ul> <p>Here's how it looks in action: </p> <p>There is also a new helper in the FormResult object that simplifies the creation of markdown links to the image. For example, if you have a field called <code>image</code> in your form result, you can use it like this in your templates:</p> <pre><code>&lt;% result.image.link %&gt;\n</code></pre>"},{"location":"blog/2024/12/09/release-notes-for-1530/#using-the-image-input","title":"Using the Image Input","text":"<p>Adding an image input to your form is very straightforward using the FormBuilder. Here's an example screenshot: </p> <p>The configuration has two main settings:</p> <ul> <li><code>filenameTemplate</code>: Define how your files will be named. You can use placeholders like <code>{{date}}</code>, <code>{{time}}</code>, or <code>{{datetime}}</code>.</li> <li><code>saveLocation</code>: Specify where in your vault the image will be saved. Don't worry if the folder doesn't exist - it will be created automatically!</li> </ul>"},{"location":"blog/2024/12/09/release-notes-for-1530/#drawbacks","title":"Drawbacks","text":"<p>As with every first version of every new feature, there is an important drawback: the image input is eager to save the image. This means that the image will be saved as soon as you select it, even if the form is not submitted, or if you pick a different image. This is a tradeoff that simplified the implementation and makes some scenarios simpler , like using the image in a markdown block or in other dynamic inputs.</p> <p>It is also worth mentioning that the value you get in the form result is not a TFile directly but a wrapped TFile object. This is because a lot of places assume it is safe to just serialize the form results to JSON, which is not the case for the TFile object. The wrapped TFile object has direct access to the most essential properties of the file, like <code>path</code>, <code>name</code>, <code>basename</code>, and <code>extension</code>. The wrapped TFile is also available through the <code>TFile</code> property in the wrapping class <code>FileProxy</code>.</p> <p>Here is an example of how you can use the wrapped TFile object:</p> <pre><code>const result = await MF.openForm(\"my-form\");\n// assuming your image input is called \"image\"\nconst file = result.image.value.TFile;\n- ctime: &lt;% file.stat.ctime %&gt;\n- mtime: &lt;% file.stat.mtime %&gt;\n- size: &lt;% file.stat.size %&gt;\n</code></pre>"},{"location":"blog/2024/12/19/release-notes-for-1560/","title":"Release notes for 1.56.0","text":""},{"location":"blog/2024/12/19/release-notes-for-1560/#templates-now-support-templater-syntax","title":"Templates now support Templater syntax","text":"<p>Modal Form 1.56.0 enhances its templates feature with Templater support! I'm particularly excited about this integration because, with a little addition we are greatly improving the usability of this plugin, but also Templater. Now binding a particular form to a complex template is easier than ever, knowing the fields available in the template also becomes a lot easier and I think the overall experience is greatly improved.</p> <p></p>"},{"location":"blog/2024/12/19/release-notes-for-1560/#whats-new","title":"What's New","text":"<p>The Templater integration adds the following capabilities to form templates:</p> <ul> <li>Use Templater syntax (<code>&lt;% %&gt;</code>) inside form templates</li> <li>Process dates, files, and system information through Templater</li> <li>Automatic processing of Templater syntax after form variables are replaced</li> </ul> <p>Here's a little example combining both syntaxes:</p> <pre><code>---\ncreated: &lt;% tp.date.now() %&gt;\n---\n\nDear {{name}},\n\nMeeting scheduled for &lt;% tp.date.now(\"MMMM Do, YYYY\") %&gt;\nLocation: {{location}}\n\nBest regards,\n{{signature}}\n</code></pre>"},{"location":"blog/2024/12/19/release-notes-for-1560/#how-it-works","title":"How it Works","text":"<p>The template processing now happens in two stages:</p> <ol> <li>First, Modal Form replaces all form variables (the <code>{{variable}}</code> syntax)</li> <li>Then, if Templater is available, it processes any Templater syntax in the resulting text</li> </ol>"},{"location":"blog/2024/12/19/release-notes-for-1560/#retry-functionality","title":"Retry Functionality","text":"<p>Getting templater templates right at the first try can be hard, that's why we added a retry option when templater processing part fails. If something goes wrong during templater processing , Modal Form now provides a retry modal where you can try to fix the template and try again.:</p> <p></p> <p>This makes it easier to fix any issues without losing your form data and gives you an insight on how te template is processed.</p> <p>Check out the templates documentation for more details and examples of how to use this new feature.</p>"},{"location":"blog/2024/12/12/modal-form-showcase-thread/","title":"Modal form showcase thread","text":"<p>Hello everyone.</p> <p>I've created this thread so people can share their awesome workflows using modal forms.</p> <p>A lot of times people that open feature requests mention they need such feature to complete their workflow, or that such feature will make their workflow simpler, and then they mention what their workflow is about and then blow my mind.</p> <p>I saw other plugins also have similar threads, so I decided to create this one to encourage people to share their forms and how are they using them.</p> <p>Anyone is free to provide their experiences however they want, but here are some suggestions that I think will make each post even more useful for everyone:</p> <ul> <li>Start the thread with a summary of the workflow or the problem you are solving.</li> <li>If you can, export your form as a JSON file and share it in the thread using a code block. This will make it easier for others to use your form.</li> <li>If you can, share a screenshot of your form. This will make it easier for others to understand what your form looks like and makes it a lot more engaging.</li> <li>If you are calling the form from a template, please share the template as well in another code block.</li> <li>If you are okay about including your post as part of the example vault on modal form repository, please say so, then others just looking at the plugin repository can see your example.</li> </ul> <p>And that's all. I'm very excited about seeing all the different workflows and how you use modal forms, and I hope this will be a great way to share and learn from each other.</p>"},{"location":"blog/archive/2024/","title":"2024","text":""}]}
\ No newline at end of file