feat: ✨ add getTaskPathWithFolders function

README.md

@@ -87,7 +87,10 @@ The following functions are contained within the `fuzzySearchLib` library:
 
 ## `getTaskPath: (task: Task) => string`
 
-Returns the full path of a task, from the project level. Nested action groups are also included
+Returns the full path of a task, from the project level. Nested action groups are also included.
+
+## `getTaskPathWithFolders: (task: Task) => string`
+Returns the full path of a task, from the root level including all folders. Nested action groups are also included.
 
 ## `searchForm: (allItems: any, itemTitles: string[], firstSelected: any, matchingFunction: Function | null) => FuzzySearchForm`
 

fuzzySearchLib.omnifocusjs/Resources/fuzzySearchLib.js

@@ -20,6 +20,26 @@ var __spreadArray = (this && this.__spreadArray) || function (to, from, pack) {
         };
         return getPath(task);
     };
+    lib.getTaskPathWithFolders = function (task) {
+        var getFolderPath = function (task) {
+            var folders = __spreadArray([], flattenedFolders, true).filter(function (folder) { return __spreadArray([], folder.flattenedProjects, true).includes(task.containingProject); });
+            var folderNames = __spreadArray([], folders, true).map(function (folder) { return folder.name; });
+            return folderNames.join(' > ');
+        };
+        var getPath = function (task) {
+            if (task.inInbox)
+                return task.name; // task in inbox
+            if (!task.parent)
+                return getFolderPath(task) + " > " + task.name; // is a project
+            if (task.containingProject && task.parent === task.containingProject.task) {
+                // task is at root of project
+                return getFolderPath(task) + " > " + task.containingProject.name + " > " + task.name;
+            }
+            else
+                return getPath(task.parent) + " > " + task.name;
+        };
+        return getPath(task);
+    };
     lib.truncateString = function (str, length) {
         if (str.length <= length)
             return str;

src/fuzzySearchLib.ts

@@ -1,5 +1,6 @@
 interface FuzzySearchLibrary extends PlugIn.Library {
   getTaskPath?: (task: Task) => string
+  getTaskPathWithFolders?: (task: Task) => string
   searchForm?: (allItems: any, itemTitles: string[], firstSelected: any, matchingFunction: Function | null) => FuzzySearchForm
   allTasksFuzzySearchForm?: () => FuzzySearchForm
   remainingTasksFuzzySearchForm?: () => FuzzySearchForm
@@ -29,6 +30,26 @@ interface FuzzySearchForm extends Form {
     return getPath(task)
   }
 
+  lib.getTaskPathWithFolders = (task: Task) => {
+
+    const getFolderPath = (task: Task) => {
+      const folders = [...flattenedFolders].filter(folder => [...folder.flattenedProjects].includes(task.containingProject))
+      const folderNames = [...folders].map(folder => folder.name)
+      return folderNames.join(' > ')
+    }
+
+    const getPath = (task: Task) => {
+      if (task.inInbox) return task.name // task in inbox
+      if (!task.parent) return `${getFolderPath(task)} > ${task.name}` // is a project
+      if (task.containingProject && task.parent === task.containingProject.task) {
+        // task is at root of project
+        return `${getFolderPath(task)} > ${task.containingProject.name} > ${task.name}`
+      }
+      else return `${getPath(task.parent)} > ${task.name}`
+    }
+    return getPath(task)
+  }
+
   lib.truncateString = (str: string, length: number) => {
     if (str.length <= length) return str
     return str.slice(0, length) + '...'

tsconfig.json

@@ -1,7 +1,7 @@
 {
     "compilerOptions": {
         "lib": [
-            "ES2019"
+            "ES2021"
         ],
         "outDir": "fuzzySearchLib.omnifocusjs/Resources"
     },