Merge branch 'curious-archaea-master'

lazyguru · lazyguru · commit 2bf690a4bb82 · 2026-02-18T21:16:36.000-07:00
diff --git a/docs/Concepts.md b/docs/Concepts.md
@@ -6,11 +6,11 @@ This plugin was designed to read code blocks in [YAML format](https://en.wikiped
 
 ### Collecting Data
 
-Providing parameters `searchType` and `searchTarget` is the minimum requirement for a successful data collection. `searchType` can be `tag`, `frontmatter`, `wiki`, `dvField`, `table`, `fileMeta`, `task`, or `text`. Then the cooresponding `searchTarget` should be provided according to the specified type.
+Providing parameters `searchType` and `searchTarget` is the minimum requirement for a successful data collection. `searchType` can be `tag`, `frontmatter`, `frontmatterlist`, `wiki`, `dvField`, `table`, `fileMeta`, `task`, or `text`. Then the cooresponding `searchTarget` should be provided according to the specified type.
 
 ### Target Evaluation
 
-Depends on the `searchType` and the `searchTarget` you provided, the evaluation of a target would be different. Simply speaking, you can track the occurrences of a target or the value attached/embedded in it.
+Depending on the `searchType` and the `searchTarget` you provided, the evaluation of a target would be different. Simply speaking, you can track the occurrences of a target or the value attached/embedded in it.
 
 To see the detail about the target evaluation, please check the document [Target Evaluation](https://github.com/pyrochlore/obsidian-tracker/blob/master/docs/TargetEvaluation.md).
 
diff --git a/docs/Examples.md b/docs/Examples.md
@@ -35,6 +35,7 @@ Check where (Location) and what (Target to Track) is your target and find the se
 | content | - [x] Say love<br>- [ ] Say love | searchType:task<br>searchTarget: Say love | O |
 | content | - [x] Say love | searchType:task.done<br>searchTarget: Say love | O |
 | content | - [ ] Say love | searchType: task.notdone<br>searchTarget: Say love | O |
+| frontmatter | habits: spanish, piano, yoga<br>([more examples](https://github.com/curious-archaea/obsidian-tracker/blob/master/docs/TargetEvaluation.md#Formatting-property-values-in-frontmatter))| searchType: frontmatterlist<br>searchTarget: habits[spanish] | O |
 
 ## Full examples
 
@@ -54,6 +55,7 @@ List of all examples
 - [Dataview Inline Field](https://github.com/pyrochlore/obsidian-tracker/blob/master/examples/TestDvField.md)
 - [Expression](https://github.com/pyrochlore/obsidian-tracker/blob/master/examples/TestExpression.md)
 - [File Meta](https://github.com/pyrochlore/obsidian-tracker/blob/master/examples/TestFileMeta.md)
+- [Frontmatter Lists](https://github.com/curious-archaea/obsidian-tracker/blob/master/examples/TestFrontmatterList.md) (New!)
 - [Legends](https://github.com/pyrochlore/obsidian-tracker/blob/master/examples/TestLegends.md)
 - [Multiple Targets / Multiple Values](https://github.com/pyrochlore/obsidian-tracker/blob/master/examples/TestMultipleTargetsMultipleValues.md)
 - [Pie Chart](https://github.com/pyrochlore/obsidian-tracker/blob/master/examples/TestPieChart.md)
diff --git a/docs/TargetEvaluation.md b/docs/TargetEvaluation.md
@@ -1,6 +1,6 @@
 # Target Evaluation
 
-From the [input parameters](https://github.com/pyrochlore/obsidian-tracker/blob/master/docs/InputParameters.md) you provided, the search targets dispersed in the notes will be counted or evaluated as a value. Tracker plugin supports eight kinds of `searchType`: `tag`, `frontmatter`, `wiki`, `text`, `table`, `dvField`, `task`, and `fileMeta`, dealing with different types of searching condition.
+From the [input parameters](https://github.com/pyrochlore/obsidian-tracker/blob/master/docs/InputParameters.md) you provided, the search targets dispersed in the notes will be counted or evaluated as a value. Tracker plugin supports nine kinds of `searchType`: `tag`, `frontmatter`, `frontmatterlist`, `wiki`, `text`, `table`, `dvField`, `task`, and `fileMeta`, dealing with different types of searching condition.
 
 ## Multiple Targets
 You can provide multiple search targets in code block by entering an array of targets separated by a comma under parameter `searchType` and `searchTarget`. Each of the targets will be identified in order and then the  values in notes will be evaluated and form a dataset indexed by that order in the array (zero-based indexing).
@@ -21,6 +21,8 @@ Many other parameters that accept multiple values (e.g. lineColor) can also be p
 
 Multiple values under a target (value tuple) separated by a slash, e.g. #bloodpressure:180/120mmHg, are supported after version 1.3.0. To identify a specific value as a target, use an accessor with bracket notation where the value in the bracket is the index by the order of values. In this case, they are bloodpressure[0] and bloodpressure[1]. You can find the example of this [here](https://github.com/pyrochlore/obsidian-tracker/blob/master/examples/BloodPressureTracker.md). You can also use a custom separator by using the parameter `separator`.
 
+**Note**: the bracket notation used with searchType: frontmatterlist (e.g. habits[yoga]) uses the same bracket syntax but serves a different purpose. It specifies a string value to match against a list, rather than a numeric index into a tuple. The two are not interchangeable.
+
 ## Search Target in Detail
 
 ### searchType: tag
@@ -51,6 +53,42 @@ mood: 10<br>
 ......<br>
 \-\-\-<br>
 
+### searchType: frontmatterlist
+This option is for vaultkeepers who want to use the same custom YAML property to track multiple targets. It is useful for tracking habits or categories recorded as a list in front matter fields *other* than tags.
+
+This search type checks whether a specific value is present in a frontmatter key that holds a list.  Ex:
+```
+habits: [habitA, habitB, habitC]
+```
+
+When specifying a searchTarget, use the key name followed by the member value in bracket notation:
+```
+searchType: frontmatterlist
+searchTarget: habits[spanish]
+```
+When the member value is present in the list, it will be evaluated as a constant value (default 1.0). When it is absent, the day will have no value. This is ideal for counting occurances. 
+
+#### Formatting property values in frontmatter
+
+Like tags, values stored in frontmatter lists are **case insensitive**. (ex: `piano` and `Piano` should be treated the same.)
+
+**Single-line lists** can optionally be surrounded by square brackets, but it's not required. Any of the following will work in frontmatter and evaluate without issue:
+- `habits: `
+- `habits: []`
+- `habits: spanish`
+- `habits: [spanish]`
+- `habits: yoga, spanish, piano`
+- `habits: [yoga, spanish, piano]`
+
+**Multi-line lists** are also allowed, ex:
+```
+habits:
+ - yoga
+ - spanish
+ - piano
+```
+
+
 ### searchType: wiki
 This search type helps you count wiki links in articles. For example,
 [[A]]
diff --git a/examples/TestFrontmatter.md b/examples/TestFrontmatter.md
@@ -36,7 +36,7 @@ line:
 ```
 
 ## Multiple Tags in Front Matter
-Extract data of one tag from multiple tags
+Extract data of one tag from multiple tags.
 The default separator in front matter tags is comma (,)
 ``` tracker
 searchType: tag
@@ -54,7 +54,7 @@ line:
     pointBorderColor: "#d65d0e"
 ```
 
-Use the data of two tags
+Use the data of two tags.
 The default separator in front matter tags is comma (,)
 ``` tracker
 searchType: tag
@@ -65,4 +65,7 @@ month:
     initMonth: 2021-01
 ```
 
-Please also check those search targets in markdown files under folder 'diary'.
+Please also check those search targets in markdown files under folder 'diary'.
+
+
+Note about multiple values: When extracting one value from a list of multiple values in frontmatter fields besides tags, please refer to TestFrontmatterList.md.
diff --git a/examples/TestFrontmatterList.md b/examples/TestFrontmatterList.md
@@ -0,0 +1,76 @@
+# Frontmatter Lists
+This option is helpful for vaultkeepers who want to track multiple habits (targets) using the same custom YAML property. 
+
+## Example outputs
+Each of the outputs below is generated by searching frontmatter for `habits: ` , then checking the list of values for the presence of a single habit, ex: `yoga`, `piano`, or `spanish`.  
+
+```tracker
+searchType: frontmatterlist
+searchTarget: habits[yoga]
+folder: diary
+startDate: 2026-02-01
+endDate: 2026-02-28
+datasetName: Yoga
+month:
+```
+
+
+
+```tracker
+searchType: frontmatterlist
+searchTarget: habits[spanish]
+folder: diary
+startDate: 2026-02-01
+endDate: 2026-02-28
+datasetName: Spanish
+month:
+	color: orange
+```
+```tracker
+searchType: frontmatterlist
+searchTarget: habits[piano]
+folder: diary
+startDate: 2026-02-01
+endDate: 2026-02-28
+datasetName: Piano
+month:
+	color: lightblue
+```
+
+```tracker
+searchType: frontmatterlist
+searchTarget: habits[piano]
+folder: diary
+startDate: 2026-02-01
+endDate: 2026-02-28
+summary:
+	template: "Total count: {{sum()}}"
+```
+
+
+
+### Testing
+
+**Bracket test**: Single-line lists can be surrounded by square brackets, but it's not required. (Trailing commas won't break anything either.)
+- 2/9: `habits: []`
+- 2/10: `habits: [piano]`
+- 2/12: `habits: [yoga, spanish]`
+- 2/16: `habits: `
+- 2/8: `habits: spanish`
+- 2/15: `habits: yoga, spanish, piano`
+
+.
+
+**Case test**:  Values stored in frontmatter lists are **case insensitive** for this plugin, mirroring the behavior of tags. In the examples above, `yoga` and `Yoga` should be treated the same. 
+
+If search targets are case insensitive, then both 2/14 and 2/17 will be highlighted on the `month:` output for `habit[yoga]` when the examples vault is viewed in Obsidian. 
+
+.
+
+**Multi-line list test**: If multi-line lists are working, then 2/14 will be highlighted on each of the calendars above when the examples vault is viewed in Obsidian. 
+```
+habits:
+ - yoga
+ - spanish
+ - piano
+```
diff --git a/examples/diary/2026-02-08.md b/examples/diary/2026-02-08.md
@@ -0,0 +1,3 @@
+---
+habits: spanish
+---
diff --git a/examples/diary/2026-02-09.md b/examples/diary/2026-02-09.md
@@ -0,0 +1,4 @@
+---
+habits: []
+---
+ Punxsutawney Phil was right :( 
diff --git a/examples/diary/2026-02-10.md b/examples/diary/2026-02-10.md
@@ -0,0 +1,4 @@
+---
+habits: [piano]
+---
+boop beep
diff --git a/examples/diary/2026-02-11.md b/examples/diary/2026-02-11.md
@@ -0,0 +1,4 @@
+---
+habits: [yoga, spanish, piano]
+---
+build all the habits
diff --git a/examples/diary/2026-02-12.md b/examples/diary/2026-02-12.md
@@ -0,0 +1,3 @@
+---
+habits: [yoga, spanish]
+---
diff --git a/examples/diary/2026-02-13.md b/examples/diary/2026-02-13.md
@@ -0,0 +1,4 @@
+---
+habits: [spanish, piano,]
+---
+a trailing comma snuck inside the brackets, but will it cause problems? tune into [[TestFrontmatterList]] tonight at 8 to find out.
diff --git a/examples/diary/2026-02-14.md b/examples/diary/2026-02-14.md
@@ -0,0 +1,7 @@
+---
+habits:
+ - yoga
+ - spanish
+ - piano
+---
+habits, but as a fancy little bullet list
diff --git a/examples/diary/2026-02-15.md b/examples/diary/2026-02-15.md
@@ -0,0 +1,5 @@
+---
+habits: yoga, spanish, piano
+---
+
+such productivity, wow
diff --git a/examples/diary/2026-02-16.md b/examples/diary/2026-02-16.md
@@ -0,0 +1,6 @@
+---
+habits: 
+---
+
+everybody deserve a little lazy day every now and then :) 
+
diff --git a/examples/diary/2026-02-17.md b/examples/diary/2026-02-17.md
@@ -0,0 +1,5 @@
+---
+habits: Yoga, spanish, Piano
+---
+
+let's get wAcKy with these cAsEs
diff --git a/examples/diary/2026-02-18.md b/examples/diary/2026-02-18.md
@@ -0,0 +1,4 @@
+---
+habits: Yoga, spanish, Piano,
+---
+a wild trailing comma appeared
diff --git a/manifest.json b/manifest.json
@@ -1,7 +1,7 @@
 {
   "id": "obsidian-tracker",
   "name": "Tracker",
-  "version": "1.17.0",
+  "version": "1.18.0",
   "minAppVersion": "0.9.12",
   "description": "A plugin tracks occurrences and numbers in your notes",
   "author": "pyrochlore",
diff --git a/rollup.config.build.mjs b/rollup.config.build.mjs
@@ -13,7 +13,15 @@ export default {
   },
   external: ['obsidian'],
   plugins: [
-    typescript(),
+    typescript({
+        // Added these lines to fix a rollup error: "Path of Typescript compiler option 'outDir' must be located inside Rollup 'dir' option."
+      tsconfig: 'tsconfig.json',
+      rootDir: 'src',
+        // outDir must be a subdirectory of Rollup's output.dir ('.') to satisfy @rollup/plugin-typescript's validation. 
+        // 'dist' is a placeholder, since TypeScript doesn't emit files here. Rollup handles all output.
+        // (there might be more elegant ways to deal with this - just not quite sure how.)
+      outDir: 'dist'
+    }),
     nodeResolve({browser: true}),
     commonjs(),
     terser()
diff --git a/src/collecting.ts b/src/collecting.ts
@@ -494,6 +494,53 @@ export function collectDataFromFrontmatterTag(
     return false;
 }
 
+// In form 'key[memberValue]', checks membership in a frontmatter list
+export function collectDataFromFrontmatterList(
+    fileCache: CachedMetadata,
+    query: Query,
+    renderInfo: RenderInfo,
+    dataMap: DataMap,
+    xValueMap: XValueMap
+): boolean {
+    let frontMatter = fileCache.frontmatter;
+    if (!frontMatter) return false;
+
+    // Parse searchTarget in the form "key[memberValue]"
+    let match = query.getTarget().match(/^(.+)\[(.+)\]$/);
+    if (!match) return false;
+
+    let listKey = match[1].trim();
+    let memberValue = match[2].trim().toLowerCase();
+
+    let rawValue = helper.deepValue(frontMatter, listKey);
+    if (rawValue == null) return false;
+
+    // Normalize to array of strings
+    let listValues: string[] = [];
+    if (Array.isArray(rawValue)) {
+        listValues = rawValue
+            .filter((v) => v != null)
+            .map((v) => String(v).trim())
+            .filter((v) => v !== "");
+    } else if (typeof rawValue === "string") {
+        listValues = rawValue
+            .split(query.getSeparator(true))
+            .map((s) => s.trim())
+            .filter((s) => s !== "");
+    } else {
+        return false;
+    }
+
+    if (listValues.some((v) => v.toLowerCase() === memberValue)) {
+        query.addNumTargets();
+        let xValue = xValueMap.get(renderInfo.xDataset[query.getId()]);
+        addToDataMap(dataMap, xValue, query, renderInfo.constValue[query.getId()]);
+        return true;
+    }
+
+    return false;
+}
+
 // In form 'key: value', target used to identify 'frontmatter key'
 export function collectDataFromFrontmatterKey(
     fileCache: CachedMetadata,
diff --git a/src/data.ts b/src/data.ts
@@ -3,6 +3,7 @@ import { Moment } from "moment";
 export enum SearchType {
     Tag,
     Frontmatter,
+    FrontmatterList, // new :) 
     Wiki,
     WikiLink,
     WikiDisplay,
diff --git a/src/main.ts b/src/main.ts
@@ -320,6 +320,7 @@ export default class Tracker extends Plugin {
                 let target = q.getTarget();
                 if (
                     type === SearchType.Frontmatter ||
+                    type === SearchType.FrontmatterList ||  // new
                     type === SearchType.Tag ||
                     type === SearchType.Wiki ||
                     type === SearchType.WikiLink ||
@@ -506,6 +507,18 @@ export default class Tracker extends Plugin {
                     processInfo.gotAnyValidYValue ||= gotAnyValue;
                 } // Search frontmatter tags
 
+                // Search frontmatter list membership
+                if (fileCache && query.getType() === SearchType.FrontmatterList) {
+                    let gotAnyValue = collecting.collectDataFromFrontmatterList(
+                        fileCache,
+                        query,
+                        renderInfo,
+                        dataMap,
+                        xValueMap
+                    );
+                    processInfo.gotAnyValidYValue ||= gotAnyValue;
+                }
+
                 // console.log("Search frontmatter keys");
                 if (
                     fileCache &&
diff --git a/src/parsing.ts b/src/parsing.ts
@@ -44,6 +44,7 @@ function validateSearchType(searchType: string): boolean {
         searchType.toLowerCase() === "tag" ||
         searchType.toLowerCase() === "text" ||
         searchType.toLowerCase() === "frontmatter" ||
+        searchType.toLowerCase() === "frontmatterlist" ||  // new
         searchType.toLowerCase() === "wiki" ||
         searchType.toLowerCase() === "wiki.link" ||
         searchType.toLowerCase() === "wiki.display" ||
@@ -1002,6 +1003,9 @@ export function getRenderInfoFromYaml(
             case "frontmatter":
                 searchType.push(SearchType.Frontmatter);
                 break;
+            case "frontmatterlist":  // new
+                searchType.push(SearchType.FrontmatterList);
+                break;
             case "wiki":
                 searchType.push(SearchType.Wiki);
                 break;
diff --git a/versions.json b/versions.json

-Original file line number
+Diff line change
@@ @@ -0,0 +1,4 @@ @@
 +---
 +habits: []
 +---
 + Punxsutawney Phil was right :(
Original file line number	Diff line number	Diff line change
`@@ -0,0 +1,3 @@`
	`1`	`+---`
	`2`	`+habits: [yoga, spanish]`
	`3`	`+---`