Update docs, config generations, fix linter

.vscode/settings.json

@@ -27,6 +27,11 @@
 		"test/tests/*.lua",
 		"utils/annotations_manual.lua"
 	],
+	"Lua.runtime.pathStrict": true,
 	"Lua.diagnostics.libraryFiles": "Enable",
-	"Lua.runtime.version": "Lua 5.1"
+	"Lua.runtime.version": "Lua 5.1",
+	"Lua.workspace.library": [
+		"~/Library/Application Support/Code/User/globalStorage/astronachos.defold",
+		"~/Library/Application Support/Code/User/workspaceStorage/72e25b7e0fdc873ee6f7baa61edbd6b1/astronachos.defold"
+	]
 }

README.md

@@ -17,9 +17,9 @@ Try the [**HTML5 version**](https://insality.github.io/druid/druid/) of the **Dr
 
 To integrate the **Druid** extension into your own project, add this project as a [dependency](https://www.defold.com/manuals/libraries/) in your **Defold** game. Open your `game.project` file and add the following line to the dependencies field under the project section:
 
-**Druid v0.11.0**
+**Druid v0.12.0**
 
-> [https://github.com/Insality/druid/archive/refs/tags/0.11.0.zip](https://github.com/Insality/druid/archive/refs/tags/0.11.0.zip)
+> [https://github.com/Insality/druid/archive/refs/tags/0.12.0.zip](https://github.com/Insality/druid/archive/refs/tags/0.12.0.zip)
 
 Here is a list of [all releases](https://github.com/Insality/druid/releases).
 

config.ld

@@ -4,7 +4,6 @@ description='Documentation for Druid Framework'
 file={"./druid",
 	exclude = {
 		"./druid/styles/",
-		"./druid/system/middleclass.lua",
 		"./druid/templates/",
 		"./druid/annotations.lua",
 		"./druid/custom/rich_text/module",

docs/modules/BaseComponent.html

@@ -106,7 +106,7 @@ <h2><a href="#Functions">Functions</a></h2>
 	<td class="summary">Context used as first arg in all Druid events</td>
 	</tr>
 	<tr>
-	<td class="name" nowrap><a href="#get_druid">get_druid(self)</a></td>
+	<td class="name" nowrap><a href="#get_druid">get_druid(self, template, nodes)</a></td>
 	<td class="summary">Get Druid instance for inner component creation.</td>
 	</tr>
 	<tr>
@@ -226,7 +226,7 @@ <h3>Returns:</h3>
 </dd>
     <dt>
     <a name = "get_druid"></a>
-    <strong>get_druid(self)</strong>
+    <strong>get_druid(self, template, nodes)</strong>
     </dt>
     <dd>
     Get Druid instance for inner component creation.
@@ -238,6 +238,14 @@ <h3>Parameters:</h3>
             <span class="types"><span class="type">BaseComponent</span></span>
          <a href="../modules/BaseComponent.html#">BaseComponent</a>
         </li>
+        <li><span class="parameter">template</span>
+            <span class="types"><a class="type" href="https://www.lua.org/manual/5.1/manual.html#5.4">string</a> or <span class="type">nil</span></span>
+         The template name
+        </li>
+        <li><span class="parameter">nodes</span>
+            <span class="types"><a class="type" href="https://www.lua.org/manual/5.1/manual.html#5.5">table</a> or <span class="type">nil</span></span>
+         The nodes table
+        </li>
     </ul>
 
     <h3>Returns:</h3>

docs/modules/DataList.html

@@ -100,22 +100,10 @@ <h2><a href="#Functions">Functions</a></h2>
 	<td class="summary">Return current data from DataList component</td>
 	</tr>
 	<tr>
-	<td class="name" nowrap><a href="#get_first_index">get_first_index(self)</a></td>
-	<td class="summary">Return first index from data.</td>
-	</tr>
-	<tr>
 	<td class="name" nowrap><a href="#get_index">get_index(self, data)</a></td>
 	<td class="summary">Return index for data value</td>
 	</tr>
 	<tr>
-	<td class="name" nowrap><a href="#get_last_index">get_last_index(self)</a></td>
-	<td class="summary">Return last index from data</td>
-	</tr>
-	<tr>
-	<td class="name" nowrap><a href="#get_length">get_length(self)</a></td>
-	<td class="summary">Return amount of data</td>
-	</tr>
-	<tr>
 	<td class="name" nowrap><a href="#init">init(self, scroll, grid, create_function)</a></td>
 	<td class="summary">The <a href="../modules/DataList.html#">DataList</a> constructor</td>
 	</tr>
@@ -131,6 +119,10 @@ <h2><a href="#Functions">Functions</a></h2>
 	<td class="name" nowrap><a href="#set_data">set_data(self, data)</a></td>
 	<td class="summary">Set new data set for DataList component</td>
 	</tr>
+	<tr>
+	<td class="name" nowrap><a href="#set_use_cache">set_use_cache(self, is_use_cache)</a></td>
+	<td class="summary">Set refresh function for DataList component</td>
+	</tr>
 </table>
 <h2><a href="#Fields">Fields</a></h2>
 <table class="function_list">
@@ -140,7 +132,7 @@ <h2><a href="#Fields">Fields</a></h2>
 	</tr>
 	<tr>
 	<td class="name" nowrap><a href="#last_index">last_index</a></td>
-	<td class="summary">The current visual last data index</td>
+	<td class="summary">The current last index of visual elements</td>
 	</tr>
 	<tr>
 	<td class="name" nowrap><a href="#on_element_add">on_element_add</a></td>
@@ -164,7 +156,7 @@ <h2><a href="#Fields">Fields</a></h2>
 	</tr>
 	<tr>
 	<td class="name" nowrap><a href="#top_index">top_index</a></td>
-	<td class="summary">The current visual top data index</td>
+	<td class="summary">The current top index of visual elements</td>
 	</tr>
 </table>
 
@@ -276,27 +268,6 @@ <h3>Returns:</h3>
 
 
 
-</dd>
-    <dt>
-    <a name = "get_first_index"></a>
-    <strong>get_first_index(self)</strong>
-    </dt>
-    <dd>
-    Return first index from data.  It not always equals to 1
-
-
-    <h3>Parameters:</h3>
-    <ul>
-        <li><span class="parameter">self</span>
-            <span class="types"><span class="type">DataList</span></span>
-         <a href="../modules/DataList.html#">DataList</a>
-        </li>
-    </ul>
-
-
-
-
-
 </dd>
     <dt>
     <a name = "get_index"></a>
@@ -322,48 +293,6 @@ <h3>Parameters:</h3>
 
 
 
-</dd>
-    <dt>
-    <a name = "get_last_index"></a>
-    <strong>get_last_index(self)</strong>
-    </dt>
-    <dd>
-    Return last index from data
-
-
-    <h3>Parameters:</h3>
-    <ul>
-        <li><span class="parameter">self</span>
-            <span class="types"><span class="type">DataList</span></span>
-         <a href="../modules/DataList.html#">DataList</a>
-        </li>
-    </ul>
-
-
-
-
-
-</dd>
-    <dt>
-    <a name = "get_length"></a>
-    <strong>get_length(self)</strong>
-    </dt>
-    <dd>
-    Return amount of data
-
-
-    <h3>Parameters:</h3>
-    <ul>
-        <li><span class="parameter">self</span>
-            <span class="types"><span class="type">DataList</span></span>
-         <a href="../modules/DataList.html#">DataList</a>
-        </li>
-    </ul>
-
-
-
-
-
 </dd>
     <dt>
     <a name = "init"></a>
@@ -474,6 +403,37 @@ <h3>Returns:</h3>
 
 
 
+</dd>
+    <dt>
+    <a name = "set_use_cache"></a>
+    <strong>set_use_cache(self, is_use_cache)</strong>
+    </dt>
+    <dd>
+    Set refresh function for DataList component
+
+
+    <h3>Parameters:</h3>
+    <ul>
+        <li><span class="parameter">self</span>
+            <span class="types"><span class="type">DataList</span></span>
+         <a href="../modules/DataList.html#">DataList</a>
+        </li>
+        <li><span class="parameter">is_use_cache</span>
+            <span class="types"><span class="type">boolean</span></span>
+         Use cache version of DataList. Requires make setup of components in on_element_add callback and clean in on_element_remove
+        </li>
+    </ul>
+
+    <h3>Returns:</h3>
+    <ol>
+
+           <span class="types"><span class="type">druid.data_list</span></span>
+        Current DataList instance
+    </ol>
+
+
+
+
 </dd>
 </dl>
     <h2 class="section-header "><a name="Fields"></a>Fields</h2>
@@ -504,7 +464,7 @@ <h2 class="section-header "><a name="Fields"></a>Fields</h2>
     <strong>last_index</strong>
     </dt>
     <dd>
-    The current visual last data index
+    The current last index of visual elements
 
 
     <ul>
@@ -624,7 +584,7 @@ <h2 class="section-header "><a name="Fields"></a>Fields</h2>
     <strong>top_index</strong>
     </dt>
     <dd>
-    The current visual top data index
+    The current top index of visual elements
 
 
     <ul>

docs/modules/Drag.html

@@ -134,11 +134,11 @@ <h2><a href="#Fields">Fields</a></h2>
 	</tr>
 	<tr>
 	<td class="name" nowrap><a href="#on_drag">on_drag</a></td>
-	<td class="summary">on drag progress callback(self, dx, dy, total_x, total_y)</td>
+	<td class="summary">on drag progress callback(self, dx, dy, total_x, total_y, touch)</td>
 	</tr>
 	<tr>
 	<td class="name" nowrap><a href="#on_drag_end">on_drag_end</a></td>
-	<td class="summary">Event on drag end callback(self, total_x, total_y)</td>
+	<td class="summary">Event on drag end callback(self, total_x, total_y, touch)</td>
 	</tr>
 	<tr>
 	<td class="name" nowrap><a href="#on_drag_start">on_drag_start</a></td>
@@ -428,7 +428,7 @@ <h2 class="section-header "><a name="Fields"></a>Fields</h2>
     <strong>on_drag</strong>
     </dt>
     <dd>
-    on drag progress callback(self, dx, dy, total_x, total_y)
+    on drag progress callback(self, dx, dy, total_x, total_y, touch)
 
 
     <ul>
@@ -448,7 +448,7 @@ <h2 class="section-header "><a name="Fields"></a>Fields</h2>
     <strong>on_drag_end</strong>
     </dt>
     <dd>
-    Event on drag end callback(self, total_x, total_y)
+    Event on drag end callback(self, total_x, total_y, touch)
 
 
     <ul>