7.10.0: Faster start-up, especially on mobile - and right-click on dates to edit

What's Changed

Please quit and restart Obsidian after updating the plugin. Thank you.

Here are the most notable user-visible changes.

🌟 Features

Add date context menu in Reading mode and Tasks Query results by @claremacrae in #3045

• Right-click on any date value - in Reading mode and Tasks query results - to make some common edits, similar to the Postpone menu, but you control which field is edited.
• Note: this feature is not yet documented, in order to allow the following bug-fix to be released.

💪 Fixes

Load cache when workspace is ready by @rxkris in #3060

• This significantly speeds up Tasks start-up time, especially on mobile.

🛠️ Behind the scenes

Improvements made to new features prior to their release:

• feat: Add date picker in Reading mode and Tasks Query results by @claremacrae in #3038
• feat: Add a date picker to the Edit Task modal by @claremacrae in #3052
• fix: Improve Edit Task modal calendar 'button' layout by @claremacrae in #3058
• fix: Improve Edit Task modal calendar button behaviour by @claremacrae in #3059
• vault: Add date picker smoke tests & fix GitHub-created sample vault by @claremacrae in #3064
• fix: remove datepicker pending usability fixes by @ilandikov and @claremacrae in #3067

Other changes:

• refactor: test QueryResultsRenderer by @ilandikov in #3040

New Contributors

• @rxkris made their first contribution in #3060

Full Changelog (including changes too small to note above, and that do not affect the behaviour of the plugin itself):

• 7.9.0...7.10.0

🙏 Support Tasks development

• https://github.com/sponsors/claremacrae

7.9.0: hide & show 'on completion' fields; one-click support for Border theme

What's Changed

Please quit and restart Obsidian after updating the plugin. Thank you.

🌟 Features

• Add hide on completion and show on completion by @claremacrae in #3033
  • Documentation: Layout.
• Add one-click support for the Border theme by @claremacrae in #3036
  • Documentation: Border Theme.

🛠️ Behind the scenes

• chore: Fix cloning on Windows by @claremacrae in #3029
• refactor: Introduce 'DateTime/' sub-directories in 'src/' and 'tests/' by @claremacrae in #3037

Full Changelog (including changes too small to note above, and that do not affect the behaviour of the plugin itself):

• 7.8.0...7.9.0

🙏 Support Tasks development

• https://github.com/sponsors/claremacrae

7.8.0: New "On Completion" feature, and small Auto Suggest fixes

What's Changed

🌟 Most Notable

Please quit and restart Obsidian after updating the plugin. Thank you.

Main changes

Here are the most notable user-visible changes.

🌟 "On Completion" action

Tip

If you have ever wished that Tasks would automatically do something with the tasks that you complete (especially likely if you use recurring tasks, which tend to accumulate within the note that holds them), then the new "On Completion" feature could be the answer!

Here's what it looks like:

- [ ] Leave me alone
- [ ] Leave me alone too! 🏁 keep
- [ ] Delete me upon completion 🏁 delete
- [ ] Delete my completed instance  📅 2024-08-12 🔁 every day 🏁 delete

See the documentation for more info.

• New "On Completion" field with support for Delete automatic action by @therden in #2840
• Add 'keep' option to "On Completion" by @claremacrae in #3016
• Teach Auto Suggest to support "On Completion" by @claremacrae in #3028

💪 Fixes

• Render numbered sub-tasks and list items in Reading view by @claremacrae in #3012
• Various improvements to cursor positions in Auto-Suggest by @claremacrae in #3020
• Better dataview space & cursor in date Auto-Suggest by @claremacrae in #3025

🛠️ Behind the scenes

Improvements made to new features prior to their release:

• refactor: Small improvements to the 'On Completion' implementation by @claremacrae in #3010
• refactor: Refactor On Completion code and tests by @claremacrae in #3015
• refactor: introduce parameter object to functions in Suggestor.ts by @claremacrae in #3022
• refactor: Make the Auto Suggest code a bit easier to maintain by @claremacrae in #3023

Other changes:

• fix: collect root ListItems by @ilandikov in #3008
• refactor: add QueryResultsRenderer class by @ilandikov in #3018
• refactor: remove QueryResultsRenderer inheritance by @ilandikov in #3027

Full Changelog (including changes too small to note above, and that do not affect the behaviour of the plugin itself):

• 7.7.0...7.8.0

🙏 Support Tasks development

• https://github.com/sponsors/claremacrae

7.7.0: Filter, sort and group by Obsidian Properties (aka YAML or frontmatter)

What's Changed

🌟 Filter, sort and group by Obsidian Properties, also known as Frontmatter or YAML

Find tasks in Kanban plugin files:

filter by function task.file.hasProperty('kanban-plugin')

Find tasks in files with value project/project-1 in the tags property:

filter by function task.file.property('tags').includes('#project/project-1')

For details and more examples, see the Obsidian Properties documentation page.

Other notable changes

📖 Documentation

• docs: Simplify the top level of documentation by @claremacrae with @aubreyz in #2995
• contrib: add documentation on testing code that uses Obsidian API by @ilandikov in #2976

🛠️ Behind the scenes

Improvements made to new features prior to their release:

• refactor: move TasksFile object to TaskLocation by @claremacrae in #2959
• fix: Prevent task.frontmatter.tags being null if no frontmatter by @claremacrae in #2974
  • Do not use this value - it is undocumented, and will change or be removed in a future release.
• test: demo property custom searches by @ilandikov with @claremacrae in #2981
• feat: releasable code for accessing properties via task.file by @ilandikov with @claremacrae in #2991
• docs: Start documenting access to obsidian properties. by @claremacrae in #2997
• docs: Update snippet in markdown by @github-actions in #2998
• docs: more work on properties documentation by @claremacrae in #3001
• fix: Editing properties/frontmatter now updates Query results by @claremacrae in #3003
• fix: Tasks in renamed files forgot about any properties/frontmatter values in the file by @claremacrae with @ilandikov in #3005

Other changes:

• chore: Add Ilyas Landikov as co-author of Tasks by @claremacrae in #2973
• refactor: remove nesting in Recurrence.next() by @ilandikov in #2970
• refactor: extract nextOccurrence() method and reuse it by @ilandikov in #2975
• refactor: create Occurrence class by @ilandikov in #2978
• refactor: move behaviour from Recurrence to Occurrence methods isIdenticalTo() and getReferenceDate() by @ilandikov in #2979
• refactor: move referenceDate field to Occurrence class by @ilandikov in #2980
• refactor: create nextOccurrence and nextOccurrenceDate methods in Occurrence by @ilandikov in #2983
• refactor: move Occurrence class separate to a separate file and minor improvements by @ilandikov in #2985
• refactor: simplify Task.handleNewStatus() by @ilandikov in #2992

Full Changelog (including changes too small to note above, and that do not affect the behaviour of the plugin itself):

• 7.6.1...7.7.0

🙏 Support Tasks development

• https://github.com/sponsors/claremacrae

7.6.1: Tasks searches now work with Tabs plugin!

What's Changed

Please quit and restart Obsidian after updating the plugin. Thank you.

Here are the most notable user-visible changes.

💪 Fixes

• fix: Tasks search results now render correctly in Tabs plugin by @claremacrae in #2945 - thanks to @xhuajin for reporting the issue and finding the fix.

Tasks can now be used in the Tabs plugin!

For example:

````tabs

tab: Todo

```tasks
folder includes Obsidian
not done
```

tab: Done

```tasks
folder includes Obsidian
done today
```

````

Might give:

📖 Documentation

• docs: fixed a minor typo by @WhoAmI-WhereAmI in #2928
• docs: Fix first task example in Getting Started by @luxedo in #2948

🛠️ Dependencies

• build(deps): bump boon-js from 2.0.4 to 2.0.5 by @dependabot in #2427
• build(deps-dev): bump eslint from 8.54.0 to 8.57.0 by @dependabot in #2902
• chore(deps): bump ws from 8.14.2 to 8.17.1 by @dependabot in #2906
• chore(deps): bump braces from 3.0.2 to 3.0.3 by @dependabot in #2907
• chore(deps-dev): bump @evilmartians/lefthook from 1.5.2 to 1.7.2 by @dependabot in #2952
• chore(deps-dev): bump markdownlint-cli2 from 0.8.1 to 0.13.0 by @dependabot in #2747
• chore(deps-dev): bump svelte-check from 3.6.0 to 3.8.4 by @dependabot in #2927

🛠️ Behind the scenes

Improvements made to new features prior to their release:

CAUTION! Do not use these - they are subject to significant changes prior to their eventual release. Thank you.

• feat: Experimental access to raw frontmatter in query.file & task.file by @claremacrae in #2940
• feat: improve access to tags by @ilandikov in #2949
• fix: Prevent task.frontmatter.tags being null if no tags in frontmatter by @claremacrae in #2951

New Contributors

• @WhoAmI-WhereAmI made their first contribution in #2928
• @luxedo made their first contribution in #2948

Full Changelog (including changes too small to note above, and that do not affect the behaviour of the plugin itself):

• 7.6.0...7.6.1

🙏 Support Tasks development

• https://github.com/sponsors/claremacrae

7.6.0: New setting for format in file names; fix 'done date' if 'when done' reached invalid date

What's Changed

🌟 Most Notable

Please quit and restart Obsidian after updating the plugin. Thank you.

• feat: New setting to recognise dates format in file names by @j0rdanba1n in #2874
  • help: Additional date format
  • implements #1369
• fix: recurrence with 'when done' could give wrong 'done' date by @claremacrae in #2919
  • fixes #2867
• docs: Update the docs for Obsidian 1.6.5 release by @claremacrae in #2917
• test: ensure dates reset by @ilandikov in #2924

New Contributors

• @j0rdanba1n made their first contribution in #2874

Full Changelog (including changes too small to note above, and that do not affect the behaviour of the plugin itself):

• 7.5.0...7.6.0

🙏 Support Tasks development

• https://github.com/sponsors/claremacrae

7.5.0: Important notice about tasks in callouts, and auto-suggest improvements

What's Changed

🌟 Most Notable

Please quit and restart Obsidian after updating the plugin. Thank you.

⚠️ Obsidian 1.6.3 and 1.6.4 callouts issue

If you use either Obsidian 1.6.3 or 1.6.4, and have tasks in callouts, please read:

• Missing tasks in callouts with some Obsidian 1.6.x versions

🌟 Features

• Increase Default Max Auto Suggestion Number to 20 by @Genei180 in #2888

💪 Fixes

• Restore the original order in Auto Suggestions menu by @Genei180 in #2889
• Tasks Auto-Suggest works again in the Kanban plugin by @claremacrae in #2908

📖 Documentation

• Update Task Dependencies.md by @liambresnahan in #2883
• Update snippets and examples in markdown by @github-actions in #2900
• Write up the Obsidian 1.6.x titled callouts issue by @claremacrae in #2910

🛠️ Behind the scenes

• refactor: Store ListItems by @stasmarkin in #2875
• test: Add tests of Obsidian cache with labelled callouts by @claremacrae in #2905
• vault: add missing end-of-line to "Smoke test Kanban Integration.md" by @github-actions in #2909

Full Changelog (including changes too small to note above, and that do not affect the behaviour of the plugin itself):

• 7.4.0...7.5.0

🙏 Support Tasks development

• https://github.com/sponsors/claremacrae

7.4.0: Add Auto-Suggest for Task Dependencies

What's Changed

🌟 Most Notable

Please quit and restart Obsidian after updating the plugin. Thank you.

🌟 Features

• Add Auto Suggest for Task dependencies by @Genei180 in #2771
  • with additional work by @claremacrae

💪 Fixes

• Correctly align 'Before ...' & 'After ...' in Edit Task modal by @ilandikov in #2864

🛠️ Behind the scenes

Improvements made to new features prior to their release:

• fix: Prevent duplicate characters at end of line if adding ID via auto-suggest by @claremacrae in #2851
• fix: Don't rewrite any existing ID when adding dependencies by @claremacrae in #2853
• feat: Re-enable auto-suggest for dependencies by @claremacrae in #2871
• fix: Prevent Auto-Suggest from making tasks with multiple ids by @claremacrae in #2876
• fix: Auto-suggest can search many more characters for dependsOn field by @claremacrae in #2877
• docs: Finalise the documentation for Auto-Suggest supporting dependencies by @claremacrae in #2879

Preparatory work for storage of indented tasks and list items in nested lists :

• feat: Store task inheritance by @stasmarkin in #2848
• refactor: encapsulate adding children in ListItem constructor by @ilandikov in #2873

Maintainability improvements for the Edit Task modal:

• refactor: Create EditableTask class by @ilandikov in #2857
• refactor: make EditableTask constructor private by @ilandikov in #2865
• refactor: Improve encapsulation of behaviour in EditableTask class by @ilandikov in #2868
• refactor: move parseAndValidateRecurrence() to EditableTask by @ilandikov in #2870

Full Changelog (including changes too small to note above, and that do not affect the behaviour of the plugin itself):

• 7.3.0...7.4.0

🙏 Support Tasks development

• https://github.com/sponsors/claremacrae

7.3.0: Add 'Remove date' option to Postpone menu

What's Changed

🌟 Most Notable

Please quit and restart Obsidian after updating the plugin. Thank you.

🌟 Features

• Add 'Remove date' option to the Postpone context menu by @claremacrae in #2844

💪 Fixes

• remove background under the dependency delete button by @ilandikov in #2835

🛠️ Behind the scenes

• chore: run update-docs-markdown.yml on ubuntu by @ilandikov in #2838
• chore: require prior agreement on fix & feature PRs by @claremacrae and @ilandikov in 12188c4
• refactor: extract RecurrenceEditor component by @ilandikov in #2832
• refactor: remove _onPriorityKeyup() by @ilandikov in #2833
• refactor: extract, simplify and test parseAndValidateRecurrence() by @ilandikov in #2839
• test: test Cache.getTasksFromFileContent() by @ilandikov and @claremacrae in #2837
• test: Add more sample data for testing Cache - and streamline its creation by @claremacrae in #2841

Full Changelog (including changes too small to note above, and that do not affect the behaviour of the plugin itself):

• 7.2.0...7.3.0

🙏 Support Tasks development

• https://github.com/sponsors/claremacrae

7.2.0: Edit Task usability on mobile, API improvements and Obsidian Tasks Custom Icons project

What's Changed

🌟 Most Notable

Please quit and restart Obsidian after updating the plugin. Thank you.

New features

• Add executeToggleTaskDoneCommand() to Tasks Api by @mgmeyers in #2781
  • see the interface and description.
• Allow showing/suppressing the Auto-Suggest in custom editor implementations by @mgmeyers in #2778
  • see the description.
• Better Edit Modal on smaller screens by @ilandikov in #2809
• Compacter look of recurrence, lines & dependencies in Edit Task modal by @ilandikov in #2811

Bug fixes

• Align the look of Priority section in task modal with date sections by @ilandikov in #2794
• Remove access keys mentions when access key setting is disabled by @ilandikov in #2796

obsidian-tasks-custom-icons

Phil Ricketts - @replete - created a lovely CSS mechanism for compact, monochrome Tasks emojis, and shared it in Discussion #1965.

As Phil is no longer using this, we have transferred it over to the obsidian-tasks-group organisation, in the new location: obsidian-tasks-group/obsidian-tasks-custom-icons. Many thanks Phil for all the work on this.

We are now looking for someone with design experience to help add support for some extra emojies. Contact @claremacrae if you would like to know more.

Coming soon...

Auto-suggest for task dependencies is coming soon, with just a little more polishing before release.

• feat: Add Auto Suggest for Task dependencies by @Genei180 in #2771
• test: Add some tests for dependency suggestions by @claremacrae in #2806
• fix: Test and improve behaviour of auto-suggest with dependencies by @claremacrae in #2826
• fix: Disable auto-suggest for dependencies to allow 7.2.0 release by @claremacrae in #2828

Other changes

Here are the other user-visible changes.

📖 Documentation

• docs: fix typo in Task Dependencies.md by @kgeis in #2792
• docs: Update snippets and examples in markdown by @github-actions in #2802
• contrib: Document the source-code directory structure by @claremacrae in #2800

🛠️ Behind the scenes

Improvements made to new features prior to their release:

Other changes:

• refactor: group CSS classes by @ilandikov in #2791
• refactor: reorder CSS classes in EditTasks.scss by @ilandikov in #2793
• refactor: clean EditTask.scss by @ilandikov in #2799
• refactor: split CSS class tasks-modal-section by @ilandikov in #2804
• refactor: finalise CSS split in `EditTask.scss by @ilandikov in #2812
• refactor: add ListItem class by @stasmarkin in #2819
• refactor: extract label generation for Edit Task modal by @ilandikov in #2822
• refactor: extract StatusEditor component from Edit Task modal by @ilandikov in #2831

New Contributors

• @kgeis made their first contribution in #2792
• @Genei180 made their first contribution in #2771
• @mgmeyers made their first contribution in #2778
• @stasmarkin made their first contribution in #2819

Full Changelog (including changes too small to note above, and that do not affect the behaviour of the plugin itself):

• 7.1.0...7.2.0

🙏 Support Tasks development

• https://github.com/sponsors/claremacrae