@real1ty-obsidian-plugins/utils 2.12.0 → 2.15.0

package/dist/file/frontmatter-diff.js

@@ -0,0 +1,162 @@
+/**
+ * Compares two frontmatter objects and returns a detailed diff.
+ * Excludes specified properties from comparison (e.g., Prisma-managed properties).
+ *
+ * @param oldFrontmatter - The original frontmatter
+ * @param newFrontmatter - The updated frontmatter
+ * @param excludeProps - Set of property keys to exclude from comparison
+ * @returns Detailed diff with categorized changes
+ */
+export function compareFrontmatter(oldFrontmatter, newFrontmatter, excludeProps = new Set()) {
+    const changes = [];
+    const added = [];
+    const modified = [];
+    const deleted = [];
+    const allKeys = new Set([...Object.keys(oldFrontmatter), ...Object.keys(newFrontmatter)]);
+    for (const key of allKeys) {
+        if (excludeProps.has(key)) {
+            continue;
+        }
+        const oldValue = oldFrontmatter[key];
+        const newValue = newFrontmatter[key];
+        if (!(key in oldFrontmatter) && key in newFrontmatter) {
+            const change = {
+                key,
+                oldValue: undefined,
+                newValue,
+                changeType: "added",
+            };
+            changes.push(change);
+            added.push(change);
+        }
+        else if (key in oldFrontmatter && !(key in newFrontmatter)) {
+            const change = {
+                key,
+                oldValue,
+                newValue: undefined,
+                changeType: "deleted",
+            };
+            changes.push(change);
+            deleted.push(change);
+        }
+        else if (!deepEqual(oldValue, newValue)) {
+            const change = {
+                key,
+                oldValue,
+                newValue,
+                changeType: "modified",
+            };
+            changes.push(change);
+            modified.push(change);
+        }
+    }
+    return {
+        hasChanges: changes.length > 0,
+        changes,
+        added,
+        modified,
+        deleted,
+    };
+}
+/**
+ * Deep equality check for frontmatter values.
+ * Handles primitives, arrays, and objects.
+ */
+function deepEqual(a, b) {
+    if (a === b)
+        return true;
+    if (a === null || b === null || a === undefined || b === undefined) {
+        return a === b;
+    }
+    if (typeof a !== typeof b)
+        return false;
+    if (Array.isArray(a) && Array.isArray(b)) {
+        if (a.length !== b.length)
+            return false;
+        return a.every((val, idx) => deepEqual(val, b[idx]));
+    }
+    if (typeof a === "object" && typeof b === "object") {
+        const keysA = Object.keys(a);
+        const keysB = Object.keys(b);
+        if (keysA.length !== keysB.length)
+            return false;
+        return keysA.every((key) => deepEqual(a[key], b[key]));
+    }
+    return false;
+}
+/**
+ * Merges multiple frontmatter diffs into a single accumulated diff.
+ * Later diffs override earlier ones for the same key.
+ *
+ * @param diffs - Array of diffs to merge (in chronological order)
+ * @returns A single merged diff containing all accumulated changes
+ */
+export function mergeFrontmatterDiffs(diffs) {
+    if (diffs.length === 0) {
+        return {
+            hasChanges: false,
+            changes: [],
+            added: [],
+            modified: [],
+            deleted: [],
+        };
+    }
+    if (diffs.length === 1) {
+        return diffs[0];
+    }
+    const changesByKey = new Map();
+    for (const diff of diffs) {
+        for (const change of diff.changes) {
+            const existing = changesByKey.get(change.key);
+            if (!existing) {
+                changesByKey.set(change.key, Object.assign({}, change));
+            }
+            else {
+                existing.newValue = change.newValue;
+                existing.changeType = change.changeType;
+                if (existing.oldValue === change.newValue) {
+                    changesByKey.delete(change.key);
+                }
+            }
+        }
+    }
+    const allChanges = Array.from(changesByKey.values());
+    const added = allChanges.filter((c) => c.changeType === "added");
+    const modified = allChanges.filter((c) => c.changeType === "modified");
+    const deleted = allChanges.filter((c) => c.changeType === "deleted");
+    return {
+        hasChanges: allChanges.length > 0,
+        changes: allChanges,
+        added,
+        modified,
+        deleted,
+    };
+}
+/**
+ * Formats a frontmatter change for display in a modal.
+ * Returns a human-readable string describing the change.
+ */
+export function formatChangeForDisplay(change) {
+    const formatValue = (value) => {
+        if (value === undefined)
+            return "(not set)";
+        if (value === null)
+            return "null";
+        if (typeof value === "string")
+            return `"${value}"`;
+        if (typeof value === "object")
+            return JSON.stringify(value);
+        if (typeof value === "number" || typeof value === "boolean")
+            return String(value);
+        return JSON.stringify(value);
+    };
+    switch (change.changeType) {
+        case "added":
+            return `+ ${change.key}: ${formatValue(change.newValue)}`;
+        case "deleted":
+            return `- ${change.key}: ${formatValue(change.oldValue)}`;
+        case "modified":
+            return `~ ${change.key}: ${formatValue(change.oldValue)} → ${formatValue(change.newValue)}`;
+    }
+}
+//# sourceMappingURL=frontmatter-diff.js.map

package/dist/file/frontmatter-diff.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"frontmatter-diff.js","sourceRoot":"","sources":["../../src/file/frontmatter-diff.ts"],"names":[],"mappings":"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","sourcesContent":["export type Frontmatter = Record<string, unknown>;\n\nexport interface FrontmatterChange {\n\tkey: string;\n\toldValue: unknown;\n\tnewValue: unknown;\n\tchangeType: \"added\" | \"modified\" | \"deleted\";\n}\n\nexport interface FrontmatterDiff {\n\thasChanges: boolean;\n\tchanges: FrontmatterChange[];\n\tadded: FrontmatterChange[];\n\tmodified: FrontmatterChange[];\n\tdeleted: FrontmatterChange[];\n}\n\n/**\n * Compares two frontmatter objects and returns a detailed diff.\n * Excludes specified properties from comparison (e.g., Prisma-managed properties).\n *\n * @param oldFrontmatter - The original frontmatter\n * @param newFrontmatter - The updated frontmatter\n * @param excludeProps - Set of property keys to exclude from comparison\n * @returns Detailed diff with categorized changes\n */\nexport function compareFrontmatter(\n\toldFrontmatter: Frontmatter,\n\tnewFrontmatter: Frontmatter,\n\texcludeProps: Set<string> = new Set()\n): FrontmatterDiff {\n\tconst changes: FrontmatterChange[] = [];\n\tconst added: FrontmatterChange[] = [];\n\tconst modified: FrontmatterChange[] = [];\n\tconst deleted: FrontmatterChange[] = [];\n\n\tconst allKeys = new Set([...Object.keys(oldFrontmatter), ...Object.keys(newFrontmatter)]);\n\n\tfor (const key of allKeys) {\n\t\tif (excludeProps.has(key)) {\n\t\t\tcontinue;\n\t\t}\n\n\t\tconst oldValue = oldFrontmatter[key];\n\t\tconst newValue = newFrontmatter[key];\n\n\t\tif (!(key in oldFrontmatter) && key in newFrontmatter) {\n\t\t\tconst change: FrontmatterChange = {\n\t\t\t\tkey,\n\t\t\t\toldValue: undefined,\n\t\t\t\tnewValue,\n\t\t\t\tchangeType: \"added\",\n\t\t\t};\n\n\t\t\tchanges.push(change);\n\t\t\tadded.push(change);\n\t\t} else if (key in oldFrontmatter && !(key in newFrontmatter)) {\n\t\t\tconst change: FrontmatterChange = {\n\t\t\t\tkey,\n\t\t\t\toldValue,\n\t\t\t\tnewValue: undefined,\n\t\t\t\tchangeType: \"deleted\",\n\t\t\t};\n\n\t\t\tchanges.push(change);\n\t\t\tdeleted.push(change);\n\t\t} else if (!deepEqual(oldValue, newValue)) {\n\t\t\tconst change: FrontmatterChange = {\n\t\t\t\tkey,\n\t\t\t\toldValue,\n\t\t\t\tnewValue,\n\t\t\t\tchangeType: \"modified\",\n\t\t\t};\n\n\t\t\tchanges.push(change);\n\t\t\tmodified.push(change);\n\t\t}\n\t}\n\n\treturn {\n\t\thasChanges: changes.length > 0,\n\t\tchanges,\n\t\tadded,\n\t\tmodified,\n\t\tdeleted,\n\t};\n}\n\n/**\n * Deep equality check for frontmatter values.\n * Handles primitives, arrays, and objects.\n */\nfunction deepEqual(a: unknown, b: unknown): boolean {\n\tif (a === b) return true;\n\n\tif (a === null || b === null || a === undefined || b === undefined) {\n\t\treturn a === b;\n\t}\n\n\tif (typeof a !== typeof b) return false;\n\n\tif (Array.isArray(a) && Array.isArray(b)) {\n\t\tif (a.length !== b.length) return false;\n\t\treturn a.every((val, idx) => deepEqual(val, b[idx]));\n\t}\n\n\tif (typeof a === \"object\" && typeof b === \"object\") {\n\t\tconst keysA = Object.keys(a as Record<string, unknown>);\n\t\tconst keysB = Object.keys(b as Record<string, unknown>);\n\n\t\tif (keysA.length !== keysB.length) return false;\n\n\t\treturn keysA.every((key) =>\n\t\t\tdeepEqual((a as Record<string, unknown>)[key], (b as Record<string, unknown>)[key])\n\t\t);\n\t}\n\n\treturn false;\n}\n\n/**\n * Merges multiple frontmatter diffs into a single accumulated diff.\n * Later diffs override earlier ones for the same key.\n *\n * @param diffs - Array of diffs to merge (in chronological order)\n * @returns A single merged diff containing all accumulated changes\n */\nexport function mergeFrontmatterDiffs(diffs: FrontmatterDiff[]): FrontmatterDiff {\n\tif (diffs.length === 0) {\n\t\treturn {\n\t\t\thasChanges: false,\n\t\t\tchanges: [],\n\t\t\tadded: [],\n\t\t\tmodified: [],\n\t\t\tdeleted: [],\n\t\t};\n\t}\n\n\tif (diffs.length === 1) {\n\t\treturn diffs[0];\n\t}\n\n\tconst changesByKey = new Map<string, FrontmatterChange>();\n\n\tfor (const diff of diffs) {\n\t\tfor (const change of diff.changes) {\n\t\t\tconst existing = changesByKey.get(change.key);\n\n\t\t\tif (!existing) {\n\t\t\t\tchangesByKey.set(change.key, { ...change });\n\t\t\t} else {\n\t\t\t\texisting.newValue = change.newValue;\n\t\t\t\texisting.changeType = change.changeType;\n\n\t\t\t\tif (existing.oldValue === change.newValue) {\n\t\t\t\t\tchangesByKey.delete(change.key);\n\t\t\t\t}\n\t\t\t}\n\t\t}\n\t}\n\n\tconst allChanges = Array.from(changesByKey.values());\n\tconst added = allChanges.filter((c) => c.changeType === \"added\");\n\tconst modified = allChanges.filter((c) => c.changeType === \"modified\");\n\tconst deleted = allChanges.filter((c) => c.changeType === \"deleted\");\n\n\treturn {\n\t\thasChanges: allChanges.length > 0,\n\t\tchanges: allChanges,\n\t\tadded,\n\t\tmodified,\n\t\tdeleted,\n\t};\n}\n\n/**\n * Formats a frontmatter change for display in a modal.\n * Returns a human-readable string describing the change.\n */\nexport function formatChangeForDisplay(change: FrontmatterChange): string {\n\tconst formatValue = (value: unknown): string => {\n\t\tif (value === undefined) return \"(not set)\";\n\t\tif (value === null) return \"null\";\n\t\tif (typeof value === \"string\") return `\"${value}\"`;\n\t\tif (typeof value === \"object\") return JSON.stringify(value);\n\t\tif (typeof value === \"number\" || typeof value === \"boolean\") return String(value);\n\t\treturn JSON.stringify(value);\n\t};\n\n\tswitch (change.changeType) {\n\t\tcase \"added\":\n\t\t\treturn `+ ${change.key}: ${formatValue(change.newValue)}`;\n\t\tcase \"deleted\":\n\t\t\treturn `- ${change.key}: ${formatValue(change.oldValue)}`;\n\t\tcase \"modified\":\n\t\t\treturn `~ ${change.key}: ${formatValue(change.oldValue)} → ${formatValue(change.newValue)}`;\n\t}\n}\n"]}

package/dist/file/index.d.ts

@@ -3,6 +3,7 @@ export * from "./file";
 export * from "./file-operations";
 export * from "./file-utils";
 export * from "./frontmatter";
+export * from "./frontmatter-diff";
 export * from "./link-parser";
 export * from "./property-utils";
 export * from "./templater";

package/dist/file/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/file/index.ts"],"names":[],"mappings":"AAAA,cAAc,mBAAmB,CAAC;AAClC,cAAc,QAAQ,CAAC;AACvB,cAAc,mBAAmB,CAAC;AAClC,cAAc,cAAc,CAAC;AAC7B,cAAc,eAAe,CAAC;AAC9B,cAAc,eAAe,CAAC;AAC9B,cAAc,kBAAkB,CAAC;AACjC,cAAc,aAAa,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/file/index.ts"],"names":[],"mappings":"AAAA,cAAc,mBAAmB,CAAC;AAClC,cAAc,QAAQ,CAAC;AACvB,cAAc,mBAAmB,CAAC;AAClC,cAAc,cAAc,CAAC;AAC7B,cAAc,eAAe,CAAC;AAC9B,cAAc,oBAAoB,CAAC;AACnC,cAAc,eAAe,CAAC;AAC9B,cAAc,kBAAkB,CAAC;AACjC,cAAc,aAAa,CAAC"}

package/dist/file/index.js

@@ -3,6 +3,7 @@ export * from "./file";
 export * from "./file-operations";
 export * from "./file-utils";
 export * from "./frontmatter";
+export * from "./frontmatter-diff";
 export * from "./link-parser";
 export * from "./property-utils";
 export * from "./templater";

package/dist/file/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/file/index.ts"],"names":[],"mappings":"AAAA,cAAc,mBAAmB,CAAC;AAClC,cAAc,QAAQ,CAAC;AACvB,cAAc,mBAAmB,CAAC;AAClC,cAAc,cAAc,CAAC;AAC7B,cAAc,eAAe,CAAC;AAC9B,cAAc,eAAe,CAAC;AAC9B,cAAc,kBAAkB,CAAC;AACjC,cAAc,aAAa,CAAC","sourcesContent":["export * from \"./child-reference\";\nexport * from \"./file\";\nexport * from \"./file-operations\";\nexport * from \"./file-utils\";\nexport * from \"./frontmatter\";\nexport * from \"./link-parser\";\nexport * from \"./property-utils\";\nexport * from \"./templater\";\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/file/index.ts"],"names":[],"mappings":"AAAA,cAAc,mBAAmB,CAAC;AAClC,cAAc,QAAQ,CAAC;AACvB,cAAc,mBAAmB,CAAC;AAClC,cAAc,cAAc,CAAC;AAC7B,cAAc,eAAe,CAAC;AAC9B,cAAc,oBAAoB,CAAC;AACnC,cAAc,eAAe,CAAC;AAC9B,cAAc,kBAAkB,CAAC;AACjC,cAAc,aAAa,CAAC","sourcesContent":["export * from \"./child-reference\";\nexport * from \"./file\";\nexport * from \"./file-operations\";\nexport * from \"./file-utils\";\nexport * from \"./frontmatter\";\nexport * from \"./frontmatter-diff\";\nexport * from \"./link-parser\";\nexport * from \"./property-utils\";\nexport * from \"./templater\";\n"]}

package/dist/index.d.ts

@@ -1,4 +1,5 @@
 export * from "./async";
+export * from "./components";
 export * from "./core";
 export * from "./date";
 export * from "./file";

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAGA,cAAc,SAAS,CAAC;AAExB,cAAc,QAAQ,CAAC;AAGvB,cAAc,QAAQ,CAAC;AAEvB,cAAc,QAAQ,CAAC;AAEvB,cAAc,UAAU,CAAC;AACzB,cAAc,YAAY,CAAC;AAE3B,cAAc,UAAU,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAGA,cAAc,SAAS,CAAC;AAExB,cAAc,cAAc,CAAC;AAE7B,cAAc,QAAQ,CAAC;AAGvB,cAAc,QAAQ,CAAC;AAEvB,cAAc,QAAQ,CAAC;AAEvB,cAAc,UAAU,CAAC;AACzB,cAAc,YAAY,CAAC;AAE3B,cAAc,UAAU,CAAC"}

package/dist/index.js

@@ -1,6 +1,8 @@
 // Settings
 // Async utilities
 export * from "./async";
+// Components
+export * from "./components";
 // Core utilities
 export * from "./core";
 // Date operations

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,WAAW;AAEX,kBAAkB;AAClB,cAAc,SAAS,CAAC;AACxB,iBAAiB;AACjB,cAAc,QAAQ,CAAC;AAEvB,kBAAkB;AAClB,cAAc,QAAQ,CAAC;AACvB,kBAAkB;AAClB,cAAc,QAAQ,CAAC;AACvB,kBAAkB;AAClB,cAAc,UAAU,CAAC;AACzB,cAAc,YAAY,CAAC;AAC3B,mBAAmB;AACnB,cAAc,UAAU,CAAC","sourcesContent":["// Settings\n\n// Async utilities\nexport * from \"./async\";\n// Core utilities\nexport * from \"./core\";\n\n// Date operations\nexport * from \"./date\";\n// File operations\nexport * from \"./file\";\n// Input utilities\nexport * from \"./inputs\";\nexport * from \"./settings\";\n// String utilities\nexport * from \"./string\";\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,WAAW;AAEX,kBAAkB;AAClB,cAAc,SAAS,CAAC;AACxB,aAAa;AACb,cAAc,cAAc,CAAC;AAC7B,iBAAiB;AACjB,cAAc,QAAQ,CAAC;AAEvB,kBAAkB;AAClB,cAAc,QAAQ,CAAC;AACvB,kBAAkB;AAClB,cAAc,QAAQ,CAAC;AACvB,kBAAkB;AAClB,cAAc,UAAU,CAAC;AACzB,cAAc,YAAY,CAAC;AAC3B,mBAAmB;AACnB,cAAc,UAAU,CAAC","sourcesContent":["// Settings\n\n// Async utilities\nexport * from \"./async\";\n// Components\nexport * from \"./components\";\n// Core utilities\nexport * from \"./core\";\n\n// Date operations\nexport * from \"./date\";\n// File operations\nexport * from \"./file\";\n// Input utilities\nexport * from \"./inputs\";\nexport * from \"./settings\";\n// String utilities\nexport * from \"./string\";\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@real1ty-obsidian-plugins/utils",
-  "version": "2.12.0",
+  "version": "2.15.0",
   "description": "Shared utilities for Obsidian plugins",
   "type": "module",
   "main": "./dist/index.js",

package/src/components/frontmatter-propagation-modal.ts

@@ -0,0 +1,111 @@
+import { type App, Modal } from "obsidian";
+
+import type { FrontmatterDiff } from "../file/frontmatter-diff";
+import { formatChangeForDisplay } from "../file/frontmatter-diff";
+
+export interface FrontmatterPropagationModalOptions {
+	eventTitle: string;
+	diff: FrontmatterDiff;
+	instanceCount: number;
+	onConfirm: () => void | Promise<void>;
+	onCancel?: () => void | Promise<void>;
+}
+
+export class FrontmatterPropagationModal extends Modal {
+	private options: FrontmatterPropagationModalOptions;
+
+	constructor(app: App, options: FrontmatterPropagationModalOptions) {
+		super(app);
+		this.options = options;
+	}
+
+	onOpen(): void {
+		const { contentEl } = this;
+
+		contentEl.empty();
+
+		contentEl.createEl("h2", { text: "Propagate frontmatter changes?" });
+
+		contentEl.createEl("p", {
+			text: `The recurring event "${this.options.eventTitle}" has frontmatter changes. Do you want to apply these changes to all ${this.options.instanceCount} physical instances?`,
+		});
+
+		const changesContainer = contentEl.createDiv({ cls: "prisma-frontmatter-changes" });
+
+		if (this.options.diff.added.length > 0) {
+			const addedSection = changesContainer.createDiv({ cls: "prisma-changes-section" });
+			addedSection.createEl("h4", { text: "Added properties:" });
+			const addedList = addedSection.createEl("ul");
+
+			for (const change of this.options.diff.added) {
+				addedList.createEl("li", {
+					text: formatChangeForDisplay(change),
+					cls: "prisma-change-added",
+				});
+			}
+		}
+
+		if (this.options.diff.modified.length > 0) {
+			const modifiedSection = changesContainer.createDiv({ cls: "prisma-changes-section" });
+			modifiedSection.createEl("h4", { text: "Modified properties:" });
+			const modifiedList = modifiedSection.createEl("ul");
+
+			for (const change of this.options.diff.modified) {
+				modifiedList.createEl("li", {
+					text: formatChangeForDisplay(change),
+					cls: "prisma-change-modified",
+				});
+			}
+		}
+
+		if (this.options.diff.deleted.length > 0) {
+			const deletedSection = changesContainer.createDiv({ cls: "prisma-changes-section" });
+			deletedSection.createEl("h4", { text: "Deleted properties:" });
+			const deletedList = deletedSection.createEl("ul");
+
+			for (const change of this.options.diff.deleted) {
+				deletedList.createEl("li", {
+					text: formatChangeForDisplay(change),
+					cls: "prisma-change-deleted",
+				});
+			}
+		}
+
+		const buttonContainer = contentEl.createDiv({ cls: "prisma-modal-buttons" });
+
+		const yesButton = buttonContainer.createEl("button", {
+			text: "Yes, propagate",
+			cls: "mod-cta",
+		});
+
+		yesButton.addEventListener("click", () => {
+			void Promise.resolve(this.options.onConfirm())
+				.then(() => {
+					this.close();
+				})
+				.catch((error) => {
+					console.error("Error in onConfirm callback:", error);
+					this.close();
+				});
+		});
+
+		const noButton = buttonContainer.createEl("button", { text: "No, skip" });
+
+		noButton.addEventListener("click", () => {
+			const result = this.options.onCancel?.();
+
+			if (result instanceof Promise) {
+				void result.catch((error) => {
+					console.error("Error in onCancel callback:", error);
+				});
+			}
+
+			this.close();
+		});
+	}
+
+	onClose(): void {
+		const { contentEl } = this;
+		contentEl.empty();
+	}
+}

package/src/components/index.ts

@@ -0,0 +1,2 @@
+export * from "./frontmatter-propagation-modal";
+export * from "./input-managers";

package/src/components/input-managers/base.ts

@@ -0,0 +1,150 @@
+export type InputManagerFilterChangeCallback = () => void;
+
+const DEFAULT_DEBOUNCE_MS = 150;
+
+export abstract class InputManager {
+	protected containerEl: HTMLElement;
+	protected inputEl: HTMLInputElement | null = null;
+	protected debounceTimer: number | null = null;
+	protected currentValue = "";
+	protected persistentlyVisible = false;
+	protected onHide?: () => void;
+	protected hiddenClass: string;
+	protected debounceMs: number;
+	protected cssClass: string;
+
+	constructor(
+		protected parentEl: HTMLElement,
+		protected placeholder: string,
+		protected cssPrefix: string,
+		protected onFilterChange: InputManagerFilterChangeCallback,
+		initiallyVisible: boolean,
+		onHide?: () => void,
+		debounceMs: number = DEFAULT_DEBOUNCE_MS
+	) {
+		this.hiddenClass = `${cssPrefix}-hidden`;
+		this.debounceMs = debounceMs;
+		this.cssClass = `${cssPrefix}-input`;
+
+		const classes = initiallyVisible
+			? `${cssPrefix}-container`
+			: `${cssPrefix}-container ${this.hiddenClass}`;
+
+		this.containerEl = this.parentEl.createEl("div", {
+			cls: classes,
+		});
+
+		this.onHide = onHide;
+
+		this.render();
+	}
+
+	private render(): void {
+		this.inputEl = this.containerEl.createEl("input", {
+			type: "text",
+			cls: this.cssClass,
+			placeholder: this.placeholder,
+		});
+
+		this.inputEl.addEventListener("input", () => {
+			this.handleInputChange();
+		});
+
+		this.inputEl.addEventListener("keydown", (evt) => {
+			if (evt.key === "Escape") {
+				// Only allow hiding if not persistently visible
+				if (!this.persistentlyVisible) {
+					this.hide();
+				} else {
+					// Just blur the input if persistently visible
+					this.inputEl?.blur();
+				}
+			} else if (evt.key === "Enter") {
+				this.applyFilterImmediately();
+			}
+		});
+	}
+
+	private handleInputChange(): void {
+		if (this.debounceTimer !== null) {
+			window.clearTimeout(this.debounceTimer);
+		}
+
+		this.debounceTimer = window.setTimeout(() => {
+			this.applyFilterImmediately();
+		}, this.debounceMs);
+	}
+
+	protected applyFilterImmediately(): void {
+		const newValue = this.inputEl?.value.trim() ?? "";
+
+		if (newValue !== this.currentValue) {
+			this.updateFilterValue(newValue);
+		}
+	}
+
+	protected updateFilterValue(value: string): void {
+		this.currentValue = value;
+
+		this.onFilterChange();
+	}
+
+	getCurrentValue(): string {
+		return this.currentValue;
+	}
+
+	show(): void {
+		this.containerEl.removeClass(this.hiddenClass);
+
+		this.inputEl?.focus();
+	}
+
+	hide(): void {
+		// Don't allow hiding if persistently visible
+		if (this.persistentlyVisible) {
+			return;
+		}
+
+		this.containerEl.addClass(this.hiddenClass);
+
+		if (this.inputEl) {
+			this.inputEl.value = "";
+		}
+
+		this.updateFilterValue("");
+
+		this.onHide?.();
+	}
+
+	focus(): void {
+		this.inputEl?.focus();
+	}
+
+	isVisible(): boolean {
+		return !this.containerEl.hasClass(this.hiddenClass);
+	}
+
+	setPersistentlyVisible(value: boolean): void {
+		this.persistentlyVisible = value;
+
+		if (value) {
+			this.show();
+		} else {
+			this.hide();
+		}
+	}
+
+	destroy(): void {
+		if (this.debounceTimer !== null) {
+			window.clearTimeout(this.debounceTimer);
+
+			this.debounceTimer = null;
+		}
+
+		this.containerEl.remove();
+
+		this.inputEl = null;
+	}
+
+	abstract shouldInclude(data: unknown): boolean;
+}

package/src/components/input-managers/expression.ts

@@ -0,0 +1,92 @@
+import { buildPropertyMapping, sanitizeExpression } from "../../core/expression-utils";
+
+import { InputManager } from "./base";
+
+export class ExpressionFilterInputManager extends InputManager {
+	private compiledFunc: ((...args: unknown[]) => boolean) | null = null;
+
+	private propertyMapping = new Map<string, string>();
+
+	private lastWarnedExpression: string | null = null;
+
+	constructor(
+		parentEl: HTMLElement,
+		cssPrefix: string,
+		onFilterChange: () => void,
+		initiallyVisible: boolean = false,
+		placeholder: string = "Status === 'Done'",
+		onHide?: () => void,
+		debounceMs?: number
+	) {
+		super(parentEl, placeholder, cssPrefix, onFilterChange, initiallyVisible, onHide, debounceMs);
+		this.cssClass = `${cssPrefix}-expression-input`;
+		if (this.inputEl) {
+			this.inputEl.className = this.cssClass;
+		}
+	}
+
+	protected updateFilterValue(filterValue: string): void {
+		super.updateFilterValue(filterValue);
+
+		this.compiledFunc = null;
+
+		this.propertyMapping.clear();
+
+		this.lastWarnedExpression = null;
+	}
+
+	shouldInclude(event: { meta?: Record<string, unknown> }): boolean {
+		if (!this.currentValue) return true;
+
+		const frontmatter = event.meta || {};
+
+		try {
+			const currentKeys = new Set(Object.keys(frontmatter));
+
+			const existingKeys = new Set(this.propertyMapping.keys());
+
+			const newKeys = [...currentKeys].filter((key) => !existingKeys.has(key));
+
+			if (newKeys.length > 0) {
+				const allKeys = new Set([...existingKeys, ...currentKeys]);
+
+				this.propertyMapping = buildPropertyMapping(Array.from(allKeys));
+
+				this.compiledFunc = null;
+			}
+
+			if (!this.compiledFunc) {
+				const sanitized = sanitizeExpression(this.currentValue, this.propertyMapping);
+
+				const params = Array.from(this.propertyMapping.values());
+
+				// eslint-disable-next-line @typescript-eslint/no-implied-eval -- Dynamic function creation for expression evaluation with sanitized input
+				this.compiledFunc = new Function(...params, `"use strict"; return ${sanitized};`) as (
+					...args: unknown[]
+				) => boolean;
+			}
+
+			const values = Array.from(this.propertyMapping.keys()).map(
+				(key) => frontmatter[key] ?? undefined
+			);
+
+			const result = this.compiledFunc(...values);
+
+			return result;
+		} catch (error) {
+			if (error instanceof ReferenceError) {
+				const hasInequality = this.currentValue.includes("!==") || this.currentValue.includes("!=");
+
+				return hasInequality;
+			}
+
+			if (this.lastWarnedExpression !== this.currentValue) {
+				console.warn("Invalid filter expression:", this.currentValue, error);
+
+				this.lastWarnedExpression = this.currentValue;
+			}
+
+			return false;
+		}
+	}
+}

package/src/components/input-managers/index.ts

@@ -0,0 +1,3 @@
+export * from "./base";
+export * from "./expression";
+export * from "./search";

package/src/components/input-managers/search.ts

@@ -0,0 +1,25 @@
+import { InputManager } from "./base";
+
+export class SearchFilterInputManager extends InputManager {
+	constructor(
+		parentEl: HTMLElement,
+		cssPrefix: string,
+		onFilterChange: () => void,
+		initiallyVisible: boolean = false,
+		placeholder: string = "Search ...",
+		onHide?: () => void,
+		debounceMs?: number
+	) {
+		super(parentEl, placeholder, cssPrefix, onFilterChange, initiallyVisible, onHide, debounceMs);
+		this.cssClass = `${cssPrefix}-search-input`;
+		if (this.inputEl) {
+			this.inputEl.className = this.cssClass;
+		}
+	}
+
+	shouldInclude(value: string): boolean {
+		if (!this.currentValue) return true;
+
+		return value.toLowerCase().includes(this.currentValue.toLowerCase());
+	}
+}

package/src/core/evaluator/base.ts

@@ -40,8 +40,17 @@ export abstract class BaseEvaluator<TRule extends BaseRule, TSettings> {
 		}
 
 		try {
-			if (this.propertyMapping.size === 0) {
-				this.propertyMapping = buildPropertyMapping(Object.keys(frontmatter));
+			// Progressively build property mapping as we encounter new properties
+			const currentKeys = new Set(Object.keys(frontmatter));
+			const existingKeys = new Set(this.propertyMapping.keys());
+			const newKeys = [...currentKeys].filter((key) => !existingKeys.has(key));
+
+			// If new properties are found, rebuild the mapping and invalidate compiled functions
+			if (newKeys.length > 0) {
+				const allKeys = new Set([...existingKeys, ...currentKeys]);
+				this.propertyMapping = buildPropertyMapping(Array.from(allKeys));
+				// Clear compiled functions since property mapping changed
+				this.compiledFunctions.clear();
 			}
 
 			let compiledFunc = this.compiledFunctions.get(rule.id);
@@ -55,7 +64,10 @@ export abstract class BaseEvaluator<TRule extends BaseRule, TSettings> {
 				this.compiledFunctions.set(rule.id, compiledFunc);
 			}
 
-			const values = Array.from(this.propertyMapping.keys()).map((key) => frontmatter[key]);
+			// Use undefined for missing properties instead of letting them be undefined implicitly
+			const values = Array.from(this.propertyMapping.keys()).map(
+				(key) => frontmatter[key] ?? undefined
+			);
 			const result = compiledFunc(...values);
 
 			return result === true;