feat: Add new priorities: highest and lowest (#1943)

* feat: added new priorities: highest and lowest

* fixed suggestor unit tests

* review changes: fixed priority numbers, changed highest icon

* fixed highest priority emoji to a star in a box

* fixed edit task modal styling

* fixed highest priority emoji to final one

* added documentation

* review changes: fixed css snippet

* review changes: fixed | symbol disappearing in quick reference docs

* review changes: fixed edit task view

Author: chrabia

docs/Advanced/Quickadd.md

@@ -31,7 +31,7 @@ Task with due date only:
 
 Task with priority and reminder date and due date:
 
-`#task {{VALUE:task name}} ⏰ {{VDATE:reminder date and time,YYYY-MM-DD HH:mm}} {{VALUE:⏫,🔼,🔽, }} 📅 {{VDATE:due date,YYYY-MM-DD}}`
+`#task {{VALUE:task name}} ⏰ {{VDATE:reminder date and time,YYYY-MM-DD HH:mm}} {{VALUE:🔺,⏫,🔼,🔽,⏬️, }} 📅 {{VDATE:due date,YYYY-MM-DD}}`
 
 <video controls width="100%">
     <source src="https://user-images.githubusercontent.com/38974541/143468599-ae598f7d-cc84-4fc9-8293-eae72cf81f8a.mov" />

docs/Advanced/Styling.md

@@ -80,7 +80,7 @@ The generic classes are:
 
 In addition to the generic classes, there are [**data attributes**](https://developer.mozilla.org/en-US/docs/Learn/HTML/Howto/Use_data_attributes) that represent the content of the various task components.
 
-A **priority data attributes** named `data-task-priority` represents the specific priority of a class. It can be `high`, `medium`, `low` or `normal`.
+A **priority data attributes** named `data-task-priority` represents the specific priority of a class. It can be `highest`, `high`, `medium`, `low`, `lowest` or `normal`.
 The `normal` value is special: it is added as a default to a task's upper `task-list-item` even if there is no priority field set for that task.
 
 A **date attribute** represents a due, created, start, scheduled or done date in a format relative to the current date.
@@ -200,6 +200,11 @@ The following rules remove the Tasks priority emoticon and render the tasks' che
 
 <!-- snippet: resources/sample_vaults/Tasks-Demo/.obsidian/snippets/tasks-plugin-priority-as-checkbox-color.css -->
 ```css
+.task-list-item[data-task-priority="highest"] input[type=checkbox] {
+    box-shadow: 0px 0px 2px 2px var(--color-purple);
+    border-color: var(--color-purple);
+}
+
 .task-list-item[data-task-priority="high"] input[type=checkbox] {
     box-shadow: 0px 0px 2px 2px var(--color-red);
     border-color: var(--color-red);
@@ -220,6 +225,11 @@ The following rules remove the Tasks priority emoticon and render the tasks' che
     border-color: var(--color-cyan);
 }
 
+.task-list-item[data-task-priority="lowest"] input[type=checkbox] {
+    box-shadow: 0px 0px 2px 2px var(--color-green);
+    border-color: var(--color-green);
+}
+
 /* This part removes the regular priority emoticon */
 span.task-priority {
     display: none;
@@ -457,6 +467,11 @@ span.tasks-list-text {
 }
 
 /* Represent tasks' priority with colorful round checkboxes instead of the priority emoticons */
+.task-list-item[data-task-priority="highest"] input[type=checkbox] {
+    box-shadow: 0px 0px 2px 2px var(--color-purple);
+    border-color: var(--color-purple);
+}
+
 .task-list-item[data-task-priority="high"] input[type=checkbox] {
     box-shadow: 0px 0px 2px 2px var(--color-red);
     border-color: var(--color-red);
@@ -477,6 +492,11 @@ span.tasks-list-text {
     border-color: var(--color-cyan);
 }
 
+.task-list-item[data-task-priority="lowest"] input[type=checkbox] {
+    box-shadow: 0px 0px 2px 2px var(--color-green);
+    border-color: var(--color-green);
+}
+
 /* This part removes the regular priority emoticon */
 span.task-priority {
     display: none;

docs/Advanced/Urgency.md

@@ -58,7 +58,11 @@ The scores are as follows:
     <td><code>0.0</code></td>
   </tr>
   <tr>
-    <td rowspan="4">Priority</td>
+    <td rowspan="6">Priority</td>
+    <td>Highest</td>
+    <td><code>9.0</code></td>
+  </tr>
+    <tr>
     <td>High</td>
     <td><code>6.0</code></td>
   </tr>
@@ -73,6 +77,10 @@ The scores are as follows:
   <tr>
     <td>Low</td>
     <td><code>0.0</code></td>
+  </tr>
+    <tr>
+    <td>Lowest</td>
+    <td><code>-0.6</code></td>
   </tr>
   <tr>
     <td rowspan="3">Scheduled</td>

docs/Getting Started/Auto-Suggest.md

@@ -174,9 +174,11 @@ Similarly, you can type some fraction of the word `start` (of whatever length is
 | Searchable Text               | Text that is added         |
 | ----------------------------- | -------------------------- |
 | ⏎                             | \<new line>                |
+| 🔺 highest priority           | 🔺                         |
 | ⏫ high priority              | ⏫                         |
 | 🔼 medium priority            | 🔼                         |
 | 🔽 low priority               | 🔽                         |
+| ⏬️ lowest priority            | ⏬️                         |
 | 🔁 recurring (repeat)         | 🔁                         |
 | every                         | 🔁 every                   |
 | every day                     | 🔁 every day               |

docs/Getting Started/Priority.md

@@ -9,10 +9,12 @@ publish: true
 Tasks can have a priority.
 In order to specify the priority of a task, you can append one of the "priority signifiers", shown here in decreasing order of priority:
 
-1. ⏫ for high priority
-2. 🔼 for medium priority
-3. use no signifier to indicate no priority
-4. 🔽 for low priority
+1. 🔺 for highest priority
+2. ⏫ for high priority
+3. 🔼 for medium priority
+4. use no signifier to indicate no priority
+5. 🔽 for low priority
+6. ⏬️ for lowest priority
 
 If a task has no priority at all, it is considered between low and medium priority.
 This means that the priority of 🔽 low tasks is considered lower than the priority of tasks without any specific priority.
@@ -35,7 +37,7 @@ Instead of adding the emoji manually, you can:
 
 The following instructions use the priority signifiers in tasks.
 
-- `priority is (above, below)? (low, none, medium, high)`
+- `priority is (above, below)? (lowest, low, none, medium, high, highest)`
   - [[Filters#Priority|Documentation]]
 - `sort by priority`
   - [[Sorting#Basics|Documentation]]

docs/Queries/Filters.md

@@ -454,14 +454,16 @@ For example:
 
 ### Priority
 
-- `priority is (above|below|not)? (low|none|medium|high)`
+- `priority is (above|below|not)? (lowest|low|none|medium|high|highest)`
 
 The available priorities are (from high to low):
 
-1. ⏫ for high priority
-2. 🔼 for medium priority
-3. use no signifier to indicate no priority (searched for with 'none')
-4. 🔽 for low priority
+1. 🔺 for highest priority
+2. ⏫ for high priority
+3. 🔼 for medium priority
+4. use no signifier to indicate no priority (searched for with 'none')
+5. 🔽 for low priority
+6. ⏬️ for lowest priority
 
 For more information, see [[Priority|Priorities]].
 

docs/Queries/Grouping.md

@@ -77,10 +77,12 @@ For more information, including adding your own customised statuses, see [[Statu
 
 1. `priority`
     - The priority of the task, namely one of:
+        - `Priority 0: Highest`
         - `Priority 1: High`
         - `Priority 2: Medium`
         - `Priority 3: None`
         - `Priority 4: Low`
+        - `Priority 5: Lowest`
 1. `urgency` ([[Urgency|urgency]])
     - Currently, the groups run from the lowest urgency to highest.
     - You can reverse this with `group by urgency reverse`.

docs/Quick Reference.md

@@ -25,7 +25,7 @@ This table summarizes the filters and other options available inside a `tasks` b
 | `is recurring`<br>`is not recurring`                                                                                                                                                                                                                                                            | `sort by recurring`                         | `group by recurring`   |                        |
 | `recurrence (includes, does not include) <string>`<br>`recurrence (regex matches, regex does not match) /regex/i`                                                                                                                                                                               |                                             | `group by recurrence`  | `hide recurrence rule` |
 | **[[Filters#Priority\|Priority]]** and **[[Urgency\|urgency]]**                                                                                                                                                                                                                                 |                                             |                        |                        |
-| `priority is (above, below, not)? (low, none, medium, high)`                                                                                                                                                                                                                                    | `sort by priority`                          | `group by priority`    | `hide priority`        |
+| `priority is (above, below, not)? (lowest, low, none, medium, high, highest)`                                                                                                                                                                                                                   | `sort by priority`                          | `group by priority`    | `hide priority`        |
 |                                                                                                                                                                                                                                                                                                 | `sort by urgency`                           | `group by urgency`     | `show urgency`         |
 | **[[Filters#Filters for File Properties\|File properties]]**                                                                                                                                                                                                                                    |                                             |                        |                        |
 | `path (includes, does not include) <path>`<br>`path (regex matches, regex does not match) /regex/i`                                                                                                                                                                                             | `sort by path`                              | `group by path`        |                        |

docs/Reference/Task Formats/Dataview Format.md

@@ -105,10 +105,12 @@ For more information, see [[Dates]].
 > These names were chosen for use in Tasks, and are not known to dataview. They can of course be searched in dataview.
 
 ```markdown
+- [ ] #task Lowest priority [priority:: lowest]
 - [ ] #task Low priority [priority:: low]
 - [ ] #task Normal priority
 - [ ] #task Medium priority [priority:: medium]
 - [ ] #task High priority [priority:: high]
+- [ ] #task Highest priority [priority:: highest]
 ```
 
 For more information, see [[Priority]].

docs/Reference/Task Formats/Tasks Emoji Format.md

@@ -23,10 +23,12 @@ For more information, see [[Dates]].
 ## Tasks Emoji Format for Priorities
 
 ```markdown
+- [ ] #task Lowest priority ⏬️
 - [ ] #task Low priority 🔽
 - [ ] #task Normal priority
 - [ ] #task Medium priority 🔼
 - [ ] #task High priority ⏫
+- [ ] #task Highest priority 🔺
 ```
 
 For more information, see [[Priority]].