@real1ty-obsidian-plugins/utils 2.4.0 → 2.6.0

package/dist/core/evaluator/base.d.ts

@@ -0,0 +1,22 @@
+import type { BehaviorSubject } from "rxjs";
+export interface BaseRule {
+    id: string;
+    expression: string;
+    enabled: boolean;
+}
+/**
+ * Generic base class for evaluating JavaScript expressions against frontmatter objects.
+ * Provides reactive compilation of rules via RxJS subscription and safe evaluation.
+ */
+export declare abstract class BaseEvaluator<TRule extends BaseRule, TSettings> {
+    protected rules: TRule[];
+    private compiledFunctions;
+    private propertyMapping;
+    private subscription;
+    constructor(settingsStore: BehaviorSubject<TSettings>);
+    protected abstract extractRules(settings: TSettings): TRule[];
+    destroy(): void;
+    protected evaluateRule(rule: TRule, frontmatter: Record<string, unknown>): boolean;
+    protected isTruthy(value: any): boolean;
+}
+//# sourceMappingURL=base.d.ts.map

package/dist/core/evaluator/base.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"base.d.ts","sourceRoot":"","sources":["../../../src/core/evaluator/base.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAgB,MAAM,MAAM,CAAC;AAI1D,MAAM,WAAW,QAAQ;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,OAAO,CAAC;CACjB;AAED;;;GAGG;AACH,8BAAsB,aAAa,CAAC,KAAK,SAAS,QAAQ,EAAE,SAAS;IACpE,SAAS,CAAC,KAAK,EAAE,KAAK,EAAE,CAAM;IAC9B,OAAO,CAAC,iBAAiB,CAA2D;IACpF,OAAO,CAAC,eAAe,CAA6B;IACpD,OAAO,CAAC,YAAY,CAA6B;gBAErC,aAAa,EAAE,eAAe,CAAC,SAAS,CAAC;IAQrD,SAAS,CAAC,QAAQ,CAAC,YAAY,CAAC,QAAQ,EAAE,SAAS,GAAG,KAAK,EAAE;IAE7D,OAAO,IAAI,IAAI;IAMf,SAAS,CAAC,YAAY,CAAC,IAAI,EAAE,KAAK,EAAE,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO;IA+BlF,SAAS,CAAC,QAAQ,CAAC,KAAK,EAAE,GAAG,GAAG,OAAO;CAGvC"}

package/dist/core/evaluator/base.js

@@ -0,0 +1,52 @@
+import { buildPropertyMapping, sanitizeExpression } from "../expression-utils";
+/**
+ * Generic base class for evaluating JavaScript expressions against frontmatter objects.
+ * Provides reactive compilation of rules via RxJS subscription and safe evaluation.
+ */
+export class BaseEvaluator {
+    constructor(settingsStore) {
+        this.rules = [];
+        this.compiledFunctions = new Map();
+        this.propertyMapping = new Map();
+        this.subscription = null;
+        this.subscription = settingsStore.subscribe((settings) => {
+            this.rules = this.extractRules(settings);
+            this.compiledFunctions.clear();
+            this.propertyMapping.clear();
+        });
+    }
+    destroy() {
+        var _a;
+        (_a = this.subscription) === null || _a === void 0 ? void 0 : _a.unsubscribe();
+        this.compiledFunctions.clear();
+        this.propertyMapping.clear();
+    }
+    evaluateRule(rule, frontmatter) {
+        if (!rule.enabled || !rule.expression) {
+            return false;
+        }
+        try {
+            if (this.propertyMapping.size === 0) {
+                this.propertyMapping = buildPropertyMapping(Object.keys(frontmatter));
+            }
+            let compiledFunc = this.compiledFunctions.get(rule.id);
+            if (!compiledFunc) {
+                const sanitized = sanitizeExpression(rule.expression, this.propertyMapping);
+                const params = Array.from(this.propertyMapping.values());
+                compiledFunc = new Function(...params, `"use strict"; return ${sanitized};`);
+                this.compiledFunctions.set(rule.id, compiledFunc);
+            }
+            const values = Array.from(this.propertyMapping.keys()).map((key) => frontmatter[key]);
+            const result = compiledFunc(...values);
+            return result === true;
+        }
+        catch (error) {
+            console.warn(`Invalid expression (${rule.id}):`, rule.expression, error);
+            return false;
+        }
+    }
+    isTruthy(value) {
+        return value === true;
+    }
+}
+//# sourceMappingURL=base.js.map

package/dist/core/evaluator/base.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"base.js","sourceRoot":"","sources":["../../../src/core/evaluator/base.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,oBAAoB,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAQ/E;;;GAGG;AACH,MAAM,OAAgB,aAAa;IAMlC,YAAY,aAAyC;QAL3C,UAAK,GAAY,EAAE,CAAC;QACtB,sBAAiB,GAAG,IAAI,GAAG,EAAgD,CAAC;QAC5E,oBAAe,GAAG,IAAI,GAAG,EAAkB,CAAC;QAC5C,iBAAY,GAAwB,IAAI,CAAC;QAGhD,IAAI,CAAC,YAAY,GAAG,aAAa,CAAC,SAAS,CAAC,CAAC,QAAQ,EAAE,EAAE;YACxD,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,YAAY,CAAC,QAAQ,CAAC,CAAC;YACzC,IAAI,CAAC,iBAAiB,CAAC,KAAK,EAAE,CAAC;YAC/B,IAAI,CAAC,eAAe,CAAC,KAAK,EAAE,CAAC;QAC9B,CAAC,CAAC,CAAC;IACJ,CAAC;IAID,OAAO;;QACN,MAAA,IAAI,CAAC,YAAY,0CAAE,WAAW,EAAE,CAAC;QACjC,IAAI,CAAC,iBAAiB,CAAC,KAAK,EAAE,CAAC;QAC/B,IAAI,CAAC,eAAe,CAAC,KAAK,EAAE,CAAC;IAC9B,CAAC;IAES,YAAY,CAAC,IAAW,EAAE,WAAoC;QACvE,IAAI,CAAC,IAAI,CAAC,OAAO,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,CAAC;YACvC,OAAO,KAAK,CAAC;QACd,CAAC;QAED,IAAI,CAAC;YACJ,IAAI,IAAI,CAAC,eAAe,CAAC,IAAI,KAAK,CAAC,EAAE,CAAC;gBACrC,IAAI,CAAC,eAAe,GAAG,oBAAoB,CAAC,MAAM,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC;YACvE,CAAC;YAED,IAAI,YAAY,GAAG,IAAI,CAAC,iBAAiB,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YAEvD,IAAI,CAAC,YAAY,EAAE,CAAC;gBACnB,MAAM,SAAS,GAAG,kBAAkB,CAAC,IAAI,CAAC,UAAU,EAAE,IAAI,CAAC,eAAe,CAAC,CAAC;gBAC5E,MAAM,MAAM,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,eAAe,CAAC,MAAM,EAAE,CAAC,CAAC;gBACzD,YAAY,GAAG,IAAI,QAAQ,CAAC,GAAG,MAAM,EAAE,wBAAwB,SAAS,GAAG,CAE/D,CAAC;gBACb,IAAI,CAAC,iBAAiB,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,EAAE,YAAY,CAAC,CAAC;YACnD,CAAC;YAED,MAAM,MAAM,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,eAAe,CAAC,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC;YACtF,MAAM,MAAM,GAAG,YAAY,CAAC,GAAG,MAAM,CAAC,CAAC;YAEvC,OAAO,MAAM,KAAK,IAAI,CAAC;QACxB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YAChB,OAAO,CAAC,IAAI,CAAC,uBAAuB,IAAI,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,UAAU,EAAE,KAAK,CAAC,CAAC;YACzE,OAAO,KAAK,CAAC;QACd,CAAC;IACF,CAAC;IAES,QAAQ,CAAC,KAAU;QAC5B,OAAO,KAAK,KAAK,IAAI,CAAC;IACvB,CAAC;CACD","sourcesContent":["import type { BehaviorSubject, Subscription } from \"rxjs\";\n\nimport { buildPropertyMapping, sanitizeExpression } from \"../expression-utils\";\n\nexport interface BaseRule {\n\tid: string;\n\texpression: string;\n\tenabled: boolean;\n}\n\n/**\n * Generic base class for evaluating JavaScript expressions against frontmatter objects.\n * Provides reactive compilation of rules via RxJS subscription and safe evaluation.\n */\nexport abstract class BaseEvaluator<TRule extends BaseRule, TSettings> {\n\tprotected rules: TRule[] = [];\n\tprivate compiledFunctions = new Map<string, ((...args: any[]) => boolean) | null>();\n\tprivate propertyMapping = new Map<string, string>();\n\tprivate subscription: Subscription | null = null;\n\n\tconstructor(settingsStore: BehaviorSubject<TSettings>) {\n\t\tthis.subscription = settingsStore.subscribe((settings) => {\n\t\t\tthis.rules = this.extractRules(settings);\n\t\t\tthis.compiledFunctions.clear();\n\t\t\tthis.propertyMapping.clear();\n\t\t});\n\t}\n\n\tprotected abstract extractRules(settings: TSettings): TRule[];\n\n\tdestroy(): void {\n\t\tthis.subscription?.unsubscribe();\n\t\tthis.compiledFunctions.clear();\n\t\tthis.propertyMapping.clear();\n\t}\n\n\tprotected evaluateRule(rule: TRule, frontmatter: Record<string, unknown>): boolean {\n\t\tif (!rule.enabled || !rule.expression) {\n\t\t\treturn false;\n\t\t}\n\n\t\ttry {\n\t\t\tif (this.propertyMapping.size === 0) {\n\t\t\t\tthis.propertyMapping = buildPropertyMapping(Object.keys(frontmatter));\n\t\t\t}\n\n\t\t\tlet compiledFunc = this.compiledFunctions.get(rule.id);\n\n\t\t\tif (!compiledFunc) {\n\t\t\t\tconst sanitized = sanitizeExpression(rule.expression, this.propertyMapping);\n\t\t\t\tconst params = Array.from(this.propertyMapping.values());\n\t\t\t\tcompiledFunc = new Function(...params, `\"use strict\"; return ${sanitized};`) as (\n\t\t\t\t\t...args: any[]\n\t\t\t\t) => boolean;\n\t\t\t\tthis.compiledFunctions.set(rule.id, compiledFunc);\n\t\t\t}\n\n\t\t\tconst values = Array.from(this.propertyMapping.keys()).map((key) => frontmatter[key]);\n\t\t\tconst result = compiledFunc(...values);\n\n\t\t\treturn result === true;\n\t\t} catch (error) {\n\t\t\tconsole.warn(`Invalid expression (${rule.id}):`, rule.expression, error);\n\t\t\treturn false;\n\t\t}\n\t}\n\n\tprotected isTruthy(value: any): boolean {\n\t\treturn value === true;\n\t}\n}\n"]}

package/dist/core/evaluator/color.d.ts

@@ -0,0 +1,19 @@
+import type { BehaviorSubject } from "rxjs";
+import { BaseEvaluator, type BaseRule } from "./base";
+export interface ColorRule extends BaseRule {
+    color: string;
+}
+/**
+ * Generic evaluator for determining colors based on frontmatter rules.
+ * Extends BaseEvaluator to evaluate color rules against frontmatter.
+ */
+export declare class ColorEvaluator<TSettings extends {
+    defaultNodeColor: string;
+    colorRules: ColorRule[];
+}> extends BaseEvaluator<ColorRule, TSettings> {
+    private defaultColor;
+    constructor(settingsStore: BehaviorSubject<TSettings>);
+    protected extractRules(settings: TSettings): ColorRule[];
+    evaluateColor(frontmatter: Record<string, unknown>): string;
+}
+//# sourceMappingURL=color.d.ts.map

package/dist/core/evaluator/color.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"color.d.ts","sourceRoot":"","sources":["../../../src/core/evaluator/color.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,MAAM,CAAC;AAE5C,OAAO,EAAE,aAAa,EAAE,KAAK,QAAQ,EAAE,MAAM,QAAQ,CAAC;AAEtD,MAAM,WAAW,SAAU,SAAQ,QAAQ;IAC1C,KAAK,EAAE,MAAM,CAAC;CACd;AAED;;;GAGG;AACH,qBAAa,cAAc,CAC1B,SAAS,SAAS;IAAE,gBAAgB,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,SAAS,EAAE,CAAA;CAAE,CACtE,SAAQ,aAAa,CAAC,SAAS,EAAE,SAAS,CAAC;IAC5C,OAAO,CAAC,YAAY,CAAS;gBAEjB,aAAa,EAAE,eAAe,CAAC,SAAS,CAAC;IAWrD,SAAS,CAAC,YAAY,CAAC,QAAQ,EAAE,SAAS,GAAG,SAAS,EAAE;IAIxD,aAAa,CAAC,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM;CAI3D"}

package/dist/core/evaluator/color.js

@@ -0,0 +1,25 @@
+import { BaseEvaluator } from "./base";
+/**
+ * Generic evaluator for determining colors based on frontmatter rules.
+ * Extends BaseEvaluator to evaluate color rules against frontmatter.
+ */
+export class ColorEvaluator extends BaseEvaluator {
+    constructor(settingsStore) {
+        super(settingsStore);
+        this.defaultColor = settingsStore.value.defaultNodeColor;
+        settingsStore.subscribe((settings) => {
+            if (settings.defaultNodeColor) {
+                this.defaultColor = settings.defaultNodeColor;
+            }
+        });
+    }
+    extractRules(settings) {
+        return settings.colorRules;
+    }
+    evaluateColor(frontmatter) {
+        var _a;
+        const match = this.rules.find((rule) => this.isTruthy(this.evaluateRule(rule, frontmatter)));
+        return (_a = match === null || match === void 0 ? void 0 : match.color) !== null && _a !== void 0 ? _a : this.defaultColor;
+    }
+}
+//# sourceMappingURL=color.js.map

package/dist/core/evaluator/color.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"color.js","sourceRoot":"","sources":["../../../src/core/evaluator/color.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,aAAa,EAAiB,MAAM,QAAQ,CAAC;AAMtD;;;GAGG;AACH,MAAM,OAAO,cAEX,SAAQ,aAAmC;IAG5C,YAAY,aAAyC;QACpD,KAAK,CAAC,aAAa,CAAC,CAAC;QACrB,IAAI,CAAC,YAAY,GAAG,aAAa,CAAC,KAAK,CAAC,gBAAgB,CAAC;QAEzD,aAAa,CAAC,SAAS,CAAC,CAAC,QAAQ,EAAE,EAAE;YACpC,IAAI,QAAQ,CAAC,gBAAgB,EAAE,CAAC;gBAC/B,IAAI,CAAC,YAAY,GAAG,QAAQ,CAAC,gBAAgB,CAAC;YAC/C,CAAC;QACF,CAAC,CAAC,CAAC;IACJ,CAAC;IAES,YAAY,CAAC,QAAmB;QACzC,OAAO,QAAQ,CAAC,UAAU,CAAC;IAC5B,CAAC;IAED,aAAa,CAAC,WAAoC;;QACjD,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,YAAY,CAAC,IAAI,EAAE,WAAW,CAAC,CAAC,CAAC,CAAC;QAC7F,OAAO,MAAA,KAAK,aAAL,KAAK,uBAAL,KAAK,CAAE,KAAK,mCAAI,IAAI,CAAC,YAAY,CAAC;IAC1C,CAAC;CACD","sourcesContent":["import type { BehaviorSubject } from \"rxjs\";\n\nimport { BaseEvaluator, type BaseRule } from \"./base\";\n\nexport interface ColorRule extends BaseRule {\n\tcolor: string;\n}\n\n/**\n * Generic evaluator for determining colors based on frontmatter rules.\n * Extends BaseEvaluator to evaluate color rules against frontmatter.\n */\nexport class ColorEvaluator<\n\tTSettings extends { defaultNodeColor: string; colorRules: ColorRule[] },\n> extends BaseEvaluator<ColorRule, TSettings> {\n\tprivate defaultColor: string;\n\n\tconstructor(settingsStore: BehaviorSubject<TSettings>) {\n\t\tsuper(settingsStore);\n\t\tthis.defaultColor = settingsStore.value.defaultNodeColor;\n\n\t\tsettingsStore.subscribe((settings) => {\n\t\t\tif (settings.defaultNodeColor) {\n\t\t\t\tthis.defaultColor = settings.defaultNodeColor;\n\t\t\t}\n\t\t});\n\t}\n\n\tprotected extractRules(settings: TSettings): ColorRule[] {\n\t\treturn settings.colorRules;\n\t}\n\n\tevaluateColor(frontmatter: Record<string, unknown>): string {\n\t\tconst match = this.rules.find((rule) => this.isTruthy(this.evaluateRule(rule, frontmatter)));\n\t\treturn match?.color ?? this.defaultColor;\n\t}\n}\n"]}

package/dist/core/evaluator/excluded.d.ts

@@ -0,0 +1,32 @@
+import type { BehaviorSubject } from "rxjs";
+export interface PathExcludedProperties {
+    id: string;
+    path: string;
+    excludedProperties: string[];
+    enabled: boolean;
+}
+/**
+ * Generic evaluator for determining which frontmatter properties to exclude when creating new nodes.
+ *
+ * Logic:
+ * 1. ALWAYS includes the default excluded properties (e.g., Parent, Child, Related, _ZettelID)
+ * 2. Checks if the source file's path matches any path-based exclusion rules
+ * 3. First matching path rule's properties are ADDED to the default exclusion list
+ * 4. Returns the combined set of excluded properties
+ */
+export declare class ExcludedPropertiesEvaluator<TSettings extends {
+    defaultExcludedProperties: string[];
+    pathExcludedProperties: PathExcludedProperties[];
+}> {
+    private defaultExcludedProperties;
+    private pathRules;
+    constructor(settingsObservable: BehaviorSubject<TSettings>);
+    /**
+     * Evaluate which properties should be excluded for a given file path.
+     *
+     * @param filePath - The file path to match against path rules
+     * @returns Array of property names to exclude (always includes defaults + path rule matches)
+     */
+    evaluateExcludedProperties(filePath: string): string[];
+}
+//# sourceMappingURL=excluded.d.ts.map

package/dist/core/evaluator/excluded.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"excluded.d.ts","sourceRoot":"","sources":["../../../src/core/evaluator/excluded.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,MAAM,CAAC;AAE5C,MAAM,WAAW,sBAAsB;IACtC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,kBAAkB,EAAE,MAAM,EAAE,CAAC;IAC7B,OAAO,EAAE,OAAO,CAAC;CACjB;AAED;;;;;;;;GAQG;AACH,qBAAa,2BAA2B,CACvC,SAAS,SAAS;IACjB,yBAAyB,EAAE,MAAM,EAAE,CAAC;IACpC,sBAAsB,EAAE,sBAAsB,EAAE,CAAC;CACjD;IAED,OAAO,CAAC,yBAAyB,CAAW;IAE5C,OAAO,CAAC,SAAS,CAA2B;gBAEhC,kBAAkB,EAAE,eAAe,CAAC,SAAS,CAAC;IAU1D;;;;;OAKG;IACH,0BAA0B,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,EAAE;CAkBtD"}

package/dist/core/evaluator/excluded.js

@@ -0,0 +1,41 @@
+/**
+ * Generic evaluator for determining which frontmatter properties to exclude when creating new nodes.
+ *
+ * Logic:
+ * 1. ALWAYS includes the default excluded properties (e.g., Parent, Child, Related, _ZettelID)
+ * 2. Checks if the source file's path matches any path-based exclusion rules
+ * 3. First matching path rule's properties are ADDED to the default exclusion list
+ * 4. Returns the combined set of excluded properties
+ */
+export class ExcludedPropertiesEvaluator {
+    constructor(settingsObservable) {
+        const assignSettings = (settings) => {
+            this.defaultExcludedProperties = settings.defaultExcludedProperties;
+            this.pathRules = settings.pathExcludedProperties.filter((rule) => rule.enabled);
+        };
+        assignSettings(settingsObservable.value);
+        settingsObservable.subscribe(assignSettings);
+    }
+    /**
+     * Evaluate which properties should be excluded for a given file path.
+     *
+     * @param filePath - The file path to match against path rules
+     * @returns Array of property names to exclude (always includes defaults + path rule matches)
+     */
+    evaluateExcludedProperties(filePath) {
+        // Always start with default excluded properties
+        const excludedProperties = [...this.defaultExcludedProperties];
+        // Find first matching path rule and add its excluded properties
+        const match = this.pathRules.find((rule) => filePath.startsWith(rule.path));
+        if (match) {
+            // Add path-specific excluded properties to the defaults
+            for (const prop of match.excludedProperties) {
+                if (!excludedProperties.includes(prop)) {
+                    excludedProperties.push(prop);
+                }
+            }
+        }
+        return excludedProperties;
+    }
+}
+//# sourceMappingURL=excluded.js.map

package/dist/core/evaluator/excluded.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"excluded.js","sourceRoot":"","sources":["../../../src/core/evaluator/excluded.ts"],"names":[],"mappings":"AASA;;;;;;;;GAQG;AACH,MAAM,OAAO,2BAA2B;IAUvC,YAAY,kBAA8C;QACzD,MAAM,cAAc,GAAG,CAAC,QAAmB,EAAE,EAAE;YAC9C,IAAI,CAAC,yBAAyB,GAAG,QAAQ,CAAC,yBAAyB,CAAC;YACpE,IAAI,CAAC,SAAS,GAAG,QAAQ,CAAC,sBAAsB,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACjF,CAAC,CAAC;QAEF,cAAc,CAAC,kBAAkB,CAAC,KAAK,CAAC,CAAC;QACzC,kBAAkB,CAAC,SAAS,CAAC,cAAc,CAAC,CAAC;IAC9C,CAAC;IAED;;;;;OAKG;IACH,0BAA0B,CAAC,QAAgB;QAC1C,gDAAgD;QAChD,MAAM,kBAAkB,GAAG,CAAC,GAAG,IAAI,CAAC,yBAAyB,CAAC,CAAC;QAE/D,gEAAgE;QAChE,MAAM,KAAK,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,QAAQ,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;QAE5E,IAAI,KAAK,EAAE,CAAC;YACX,wDAAwD;YACxD,KAAK,MAAM,IAAI,IAAI,KAAK,CAAC,kBAAkB,EAAE,CAAC;gBAC7C,IAAI,CAAC,kBAAkB,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;oBACxC,kBAAkB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;gBAC/B,CAAC;YACF,CAAC;QACF,CAAC;QAED,OAAO,kBAAkB,CAAC;IAC3B,CAAC;CACD","sourcesContent":["import type { BehaviorSubject } from \"rxjs\";\n\nexport interface PathExcludedProperties {\n\tid: string;\n\tpath: string;\n\texcludedProperties: string[];\n\tenabled: boolean;\n}\n\n/**\n * Generic evaluator for determining which frontmatter properties to exclude when creating new nodes.\n *\n * Logic:\n * 1. ALWAYS includes the default excluded properties (e.g., Parent, Child, Related, _ZettelID)\n * 2. Checks if the source file's path matches any path-based exclusion rules\n * 3. First matching path rule's properties are ADDED to the default exclusion list\n * 4. Returns the combined set of excluded properties\n */\nexport class ExcludedPropertiesEvaluator<\n\tTSettings extends {\n\t\tdefaultExcludedProperties: string[];\n\t\tpathExcludedProperties: PathExcludedProperties[];\n\t},\n> {\n\tprivate defaultExcludedProperties: string[];\n\n\tprivate pathRules: PathExcludedProperties[];\n\n\tconstructor(settingsObservable: BehaviorSubject<TSettings>) {\n\t\tconst assignSettings = (settings: TSettings) => {\n\t\t\tthis.defaultExcludedProperties = settings.defaultExcludedProperties;\n\t\t\tthis.pathRules = settings.pathExcludedProperties.filter((rule) => rule.enabled);\n\t\t};\n\n\t\tassignSettings(settingsObservable.value);\n\t\tsettingsObservable.subscribe(assignSettings);\n\t}\n\n\t/**\n\t * Evaluate which properties should be excluded for a given file path.\n\t *\n\t * @param filePath - The file path to match against path rules\n\t * @returns Array of property names to exclude (always includes defaults + path rule matches)\n\t */\n\tevaluateExcludedProperties(filePath: string): string[] {\n\t\t// Always start with default excluded properties\n\t\tconst excludedProperties = [...this.defaultExcludedProperties];\n\n\t\t// Find first matching path rule and add its excluded properties\n\t\tconst match = this.pathRules.find((rule) => filePath.startsWith(rule.path));\n\n\t\tif (match) {\n\t\t\t// Add path-specific excluded properties to the defaults\n\t\t\tfor (const prop of match.excludedProperties) {\n\t\t\t\tif (!excludedProperties.includes(prop)) {\n\t\t\t\t\texcludedProperties.push(prop);\n\t\t\t\t}\n\t\t\t}\n\t\t}\n\n\t\treturn excludedProperties;\n\t}\n}\n"]}

package/dist/core/evaluator/filter.d.ts

@@ -0,0 +1,15 @@
+import { BaseEvaluator, type BaseRule } from "./base";
+export interface FilterRule extends BaseRule {
+}
+/**
+ * Generic evaluator for filtering based on frontmatter expressions.
+ * Extends BaseEvaluator to evaluate filter rules against frontmatter.
+ * Returns true only if ALL rules evaluate to true.
+ */
+export declare class FilterEvaluator<TSettings extends {
+    filterExpressions: string[];
+}> extends BaseEvaluator<FilterRule, TSettings> {
+    protected extractRules(settings: TSettings): FilterRule[];
+    evaluateFilters(frontmatter: Record<string, unknown>): boolean;
+}
+//# sourceMappingURL=filter.d.ts.map

package/dist/core/evaluator/filter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"filter.d.ts","sourceRoot":"","sources":["../../../src/core/evaluator/filter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,KAAK,QAAQ,EAAE,MAAM,QAAQ,CAAC;AAEtD,MAAM,WAAW,UAAW,SAAQ,QAAQ;CAAG;AAE/C;;;;GAIG;AACH,qBAAa,eAAe,CAC3B,SAAS,SAAS;IAAE,iBAAiB,EAAE,MAAM,EAAE,CAAA;CAAE,CAChD,SAAQ,aAAa,CAAC,UAAU,EAAE,SAAS,CAAC;IAC7C,SAAS,CAAC,YAAY,CAAC,QAAQ,EAAE,SAAS,GAAG,UAAU,EAAE;IAQzD,eAAe,CAAC,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO;CAY9D"}

package/dist/core/evaluator/filter.js

@@ -0,0 +1,27 @@
+import { BaseEvaluator } from "./base";
+/**
+ * Generic evaluator for filtering based on frontmatter expressions.
+ * Extends BaseEvaluator to evaluate filter rules against frontmatter.
+ * Returns true only if ALL rules evaluate to true.
+ */
+export class FilterEvaluator extends BaseEvaluator {
+    extractRules(settings) {
+        return settings.filterExpressions.map((expression, index) => ({
+            id: `filter-${index}`,
+            expression: expression.trim(),
+            enabled: true,
+        }));
+    }
+    evaluateFilters(frontmatter) {
+        if (this.rules.length === 0) {
+            return true;
+        }
+        return this.rules.every((rule) => {
+            if (!rule.enabled || !rule.expression) {
+                return true;
+            }
+            return this.evaluateRule(rule, frontmatter);
+        });
+    }
+}
+//# sourceMappingURL=filter.js.map

package/dist/core/evaluator/filter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"filter.js","sourceRoot":"","sources":["../../../src/core/evaluator/filter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAiB,MAAM,QAAQ,CAAC;AAItD;;;;GAIG;AACH,MAAM,OAAO,eAEX,SAAQ,aAAoC;IACnC,YAAY,CAAC,QAAmB;QACzC,OAAO,QAAQ,CAAC,iBAAiB,CAAC,GAAG,CAAC,CAAC,UAAU,EAAE,KAAK,EAAE,EAAE,CAAC,CAAC;YAC7D,EAAE,EAAE,UAAU,KAAK,EAAE;YACrB,UAAU,EAAE,UAAU,CAAC,IAAI,EAAE;YAC7B,OAAO,EAAE,IAAI;SACb,CAAC,CAAC,CAAC;IACL,CAAC;IAED,eAAe,CAAC,WAAoC;QACnD,IAAI,IAAI,CAAC,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC7B,OAAO,IAAI,CAAC;QACb,CAAC;QAED,OAAO,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,IAAI,EAAE,EAAE;YAChC,IAAI,CAAC,IAAI,CAAC,OAAO,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,CAAC;gBACvC,OAAO,IAAI,CAAC;YACb,CAAC;YACD,OAAO,IAAI,CAAC,YAAY,CAAC,IAAI,EAAE,WAAW,CAAC,CAAC;QAC7C,CAAC,CAAC,CAAC;IACJ,CAAC;CACD","sourcesContent":["import { BaseEvaluator, type BaseRule } from \"./base\";\n\nexport interface FilterRule extends BaseRule {}\n\n/**\n * Generic evaluator for filtering based on frontmatter expressions.\n * Extends BaseEvaluator to evaluate filter rules against frontmatter.\n * Returns true only if ALL rules evaluate to true.\n */\nexport class FilterEvaluator<\n\tTSettings extends { filterExpressions: string[] },\n> extends BaseEvaluator<FilterRule, TSettings> {\n\tprotected extractRules(settings: TSettings): FilterRule[] {\n\t\treturn settings.filterExpressions.map((expression, index) => ({\n\t\t\tid: `filter-${index}`,\n\t\t\texpression: expression.trim(),\n\t\t\tenabled: true,\n\t\t}));\n\t}\n\n\tevaluateFilters(frontmatter: Record<string, unknown>): boolean {\n\t\tif (this.rules.length === 0) {\n\t\t\treturn true;\n\t\t}\n\n\t\treturn this.rules.every((rule) => {\n\t\t\tif (!rule.enabled || !rule.expression) {\n\t\t\t\treturn true;\n\t\t\t}\n\t\t\treturn this.evaluateRule(rule, frontmatter);\n\t\t});\n\t}\n}\n"]}

package/dist/core/evaluator/included.d.ts

@@ -0,0 +1,36 @@
+import type { BehaviorSubject } from "rxjs";
+export interface PathIncludedProperties {
+    id: string;
+    path: string;
+    includedProperties: string[];
+    enabled: boolean;
+}
+/**
+ * Generic evaluator for determining which properties to include in Bases view columns.
+ *
+ * Logic:
+ * 1. ALWAYS includes the default included properties
+ * 2. Checks if the file's path matches any path-based inclusion rules
+ * 3. First matching path rule's properties are ADDED to the default inclusion list
+ * 4. Returns the combined set of included properties in order:
+ *    - file.name (always first)
+ *    - default included properties (in specified order)
+ *    - path-specific included properties (in specified order)
+ */
+export declare class IncludedPropertiesEvaluator<TSettings extends {
+    defaultBasesIncludedProperties: string[];
+    pathBasesIncludedProperties: PathIncludedProperties[];
+}> {
+    private defaultIncludedProperties;
+    private pathRules;
+    constructor(settingsObservable: BehaviorSubject<TSettings>);
+    /**
+     * Evaluate which properties should be included in the order array for a given file path.
+     * Returns an array with "file.name" as the first element, followed by default and path-specific properties.
+     *
+     * @param filePath - The file path to match against path rules
+     * @returns Array of property names to include in the order (file.name + defaults + path rule matches)
+     */
+    evaluateIncludedProperties(filePath: string): string[];
+}
+//# sourceMappingURL=included.d.ts.map

package/dist/core/evaluator/included.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"included.d.ts","sourceRoot":"","sources":["../../../src/core/evaluator/included.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,MAAM,CAAC;AAE5C,MAAM,WAAW,sBAAsB;IACtC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,kBAAkB,EAAE,MAAM,EAAE,CAAC;IAC7B,OAAO,EAAE,OAAO,CAAC;CACjB;AAED;;;;;;;;;;;GAWG;AACH,qBAAa,2BAA2B,CACvC,SAAS,SAAS;IACjB,8BAA8B,EAAE,MAAM,EAAE,CAAC;IACzC,2BAA2B,EAAE,sBAAsB,EAAE,CAAC;CACtD;IAED,OAAO,CAAC,yBAAyB,CAAW;IAE5C,OAAO,CAAC,SAAS,CAA2B;gBAEhC,kBAAkB,EAAE,eAAe,CAAC,SAAS,CAAC;IAU1D;;;;;;OAMG;IACH,0BAA0B,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,EAAE;CAyBtD"}

package/dist/core/evaluator/included.js

@@ -0,0 +1,51 @@
+/**
+ * Generic evaluator for determining which properties to include in Bases view columns.
+ *
+ * Logic:
+ * 1. ALWAYS includes the default included properties
+ * 2. Checks if the file's path matches any path-based inclusion rules
+ * 3. First matching path rule's properties are ADDED to the default inclusion list
+ * 4. Returns the combined set of included properties in order:
+ *    - file.name (always first)
+ *    - default included properties (in specified order)
+ *    - path-specific included properties (in specified order)
+ */
+export class IncludedPropertiesEvaluator {
+    constructor(settingsObservable) {
+        const assignSettings = (settings) => {
+            this.defaultIncludedProperties = settings.defaultBasesIncludedProperties;
+            this.pathRules = settings.pathBasesIncludedProperties.filter((rule) => rule.enabled);
+        };
+        assignSettings(settingsObservable.value);
+        settingsObservable.subscribe(assignSettings);
+    }
+    /**
+     * Evaluate which properties should be included in the order array for a given file path.
+     * Returns an array with "file.name" as the first element, followed by default and path-specific properties.
+     *
+     * @param filePath - The file path to match against path rules
+     * @returns Array of property names to include in the order (file.name + defaults + path rule matches)
+     */
+    evaluateIncludedProperties(filePath) {
+        // Always start with file.name
+        const includedProperties = ["file.name"];
+        // Add default included properties
+        for (const prop of this.defaultIncludedProperties) {
+            if (!includedProperties.includes(prop)) {
+                includedProperties.push(prop);
+            }
+        }
+        // Find first matching path rule and add its included properties
+        const match = this.pathRules.find((rule) => filePath.startsWith(rule.path));
+        if (match) {
+            // Add path-specific included properties to the defaults
+            for (const prop of match.includedProperties) {
+                if (!includedProperties.includes(prop)) {
+                    includedProperties.push(prop);
+                }
+            }
+        }
+        return includedProperties;
+    }
+}
+//# sourceMappingURL=included.js.map

package/dist/core/evaluator/included.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"included.js","sourceRoot":"","sources":["../../../src/core/evaluator/included.ts"],"names":[],"mappings":"AASA;;;;;;;;;;;GAWG;AACH,MAAM,OAAO,2BAA2B;IAUvC,YAAY,kBAA8C;QACzD,MAAM,cAAc,GAAG,CAAC,QAAmB,EAAE,EAAE;YAC9C,IAAI,CAAC,yBAAyB,GAAG,QAAQ,CAAC,8BAA8B,CAAC;YACzE,IAAI,CAAC,SAAS,GAAG,QAAQ,CAAC,2BAA2B,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACtF,CAAC,CAAC;QAEF,cAAc,CAAC,kBAAkB,CAAC,KAAK,CAAC,CAAC;QACzC,kBAAkB,CAAC,SAAS,CAAC,cAAc,CAAC,CAAC;IAC9C,CAAC;IAED;;;;;;OAMG;IACH,0BAA0B,CAAC,QAAgB;QAC1C,8BAA8B;QAC9B,MAAM,kBAAkB,GAAG,CAAC,WAAW,CAAC,CAAC;QAEzC,kCAAkC;QAClC,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,yBAAyB,EAAE,CAAC;YACnD,IAAI,CAAC,kBAAkB,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;gBACxC,kBAAkB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAC/B,CAAC;QACF,CAAC;QAED,gEAAgE;QAChE,MAAM,KAAK,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,QAAQ,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;QAE5E,IAAI,KAAK,EAAE,CAAC;YACX,wDAAwD;YACxD,KAAK,MAAM,IAAI,IAAI,KAAK,CAAC,kBAAkB,EAAE,CAAC;gBAC7C,IAAI,CAAC,kBAAkB,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;oBACxC,kBAAkB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;gBAC/B,CAAC;YACF,CAAC;QACF,CAAC;QAED,OAAO,kBAAkB,CAAC;IAC3B,CAAC;CACD","sourcesContent":["import type { BehaviorSubject } from \"rxjs\";\n\nexport interface PathIncludedProperties {\n\tid: string;\n\tpath: string;\n\tincludedProperties: string[];\n\tenabled: boolean;\n}\n\n/**\n * Generic evaluator for determining which properties to include in Bases view columns.\n *\n * Logic:\n * 1. ALWAYS includes the default included properties\n * 2. Checks if the file's path matches any path-based inclusion rules\n * 3. First matching path rule's properties are ADDED to the default inclusion list\n * 4. Returns the combined set of included properties in order:\n *    - file.name (always first)\n *    - default included properties (in specified order)\n *    - path-specific included properties (in specified order)\n */\nexport class IncludedPropertiesEvaluator<\n\tTSettings extends {\n\t\tdefaultBasesIncludedProperties: string[];\n\t\tpathBasesIncludedProperties: PathIncludedProperties[];\n\t},\n> {\n\tprivate defaultIncludedProperties: string[];\n\n\tprivate pathRules: PathIncludedProperties[];\n\n\tconstructor(settingsObservable: BehaviorSubject<TSettings>) {\n\t\tconst assignSettings = (settings: TSettings) => {\n\t\t\tthis.defaultIncludedProperties = settings.defaultBasesIncludedProperties;\n\t\t\tthis.pathRules = settings.pathBasesIncludedProperties.filter((rule) => rule.enabled);\n\t\t};\n\n\t\tassignSettings(settingsObservable.value);\n\t\tsettingsObservable.subscribe(assignSettings);\n\t}\n\n\t/**\n\t * Evaluate which properties should be included in the order array for a given file path.\n\t * Returns an array with \"file.name\" as the first element, followed by default and path-specific properties.\n\t *\n\t * @param filePath - The file path to match against path rules\n\t * @returns Array of property names to include in the order (file.name + defaults + path rule matches)\n\t */\n\tevaluateIncludedProperties(filePath: string): string[] {\n\t\t// Always start with file.name\n\t\tconst includedProperties = [\"file.name\"];\n\n\t\t// Add default included properties\n\t\tfor (const prop of this.defaultIncludedProperties) {\n\t\t\tif (!includedProperties.includes(prop)) {\n\t\t\t\tincludedProperties.push(prop);\n\t\t\t}\n\t\t}\n\n\t\t// Find first matching path rule and add its included properties\n\t\tconst match = this.pathRules.find((rule) => filePath.startsWith(rule.path));\n\n\t\tif (match) {\n\t\t\t// Add path-specific included properties to the defaults\n\t\t\tfor (const prop of match.includedProperties) {\n\t\t\t\tif (!includedProperties.includes(prop)) {\n\t\t\t\t\tincludedProperties.push(prop);\n\t\t\t\t}\n\t\t\t}\n\t\t}\n\n\t\treturn includedProperties;\n\t}\n}\n"]}

package/dist/core/evaluator/index.d.ts

@@ -0,0 +1,6 @@
+export * from "./base";
+export * from "./color";
+export * from "./excluded";
+export * from "./filter";
+export * from "./included";
+//# sourceMappingURL=index.d.ts.map

package/dist/core/evaluator/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/core/evaluator/index.ts"],"names":[],"mappings":"AAAA,cAAc,QAAQ,CAAC;AACvB,cAAc,SAAS,CAAC;AACxB,cAAc,YAAY,CAAC;AAC3B,cAAc,UAAU,CAAC;AACzB,cAAc,YAAY,CAAC"}

package/dist/core/evaluator/index.js

@@ -0,0 +1,6 @@
+export * from "./base";
+export * from "./color";
+export * from "./excluded";
+export * from "./filter";
+export * from "./included";
+//# sourceMappingURL=index.js.map

package/dist/core/evaluator/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/core/evaluator/index.ts"],"names":[],"mappings":"AAAA,cAAc,QAAQ,CAAC;AACvB,cAAc,SAAS,CAAC;AACxB,cAAc,YAAY,CAAC;AAC3B,cAAc,UAAU,CAAC;AACzB,cAAc,YAAY,CAAC","sourcesContent":["export * from \"./base\";\nexport * from \"./color\";\nexport * from \"./excluded\";\nexport * from \"./filter\";\nexport * from \"./included\";\n"]}

package/dist/core/expression-utils.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Sanitizes a property name for use as a JavaScript function parameter
+ * by replacing spaces and special characters with underscores.
+ * Adds a prefix to avoid conflicts with JavaScript reserved words.
+ */
+export declare function sanitizePropertyName(name: string): string;
+/**
+ * Builds a mapping of original property names to sanitized versions
+ * suitable for use as JavaScript function parameters.
+ */
+export declare function buildPropertyMapping(properties: string[]): Map<string, string>;
+/**
+ * Replaces property names in an expression with their sanitized versions.
+ * Sorts by length descending to replace longer property names first and avoid partial matches.
+ */
+export declare function sanitizeExpression(expression: string, propertyMapping: Map<string, string>): string;
+//# sourceMappingURL=expression-utils.d.ts.map

package/dist/core/expression-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"expression-utils.d.ts","sourceRoot":"","sources":["../../src/core/expression-utils.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAGzD;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,UAAU,EAAE,MAAM,EAAE,GAAG,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAQ9E;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CACjC,UAAU,EAAE,MAAM,EAClB,eAAe,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,GAClC,MAAM,CAqBR"}

package/dist/core/expression-utils.js

@@ -0,0 +1,40 @@
+/**
+ * Sanitizes a property name for use as a JavaScript function parameter
+ * by replacing spaces and special characters with underscores.
+ * Adds a prefix to avoid conflicts with JavaScript reserved words.
+ */
+export function sanitizePropertyName(name) {
+    const sanitized = name.replace(/[^a-zA-Z0-9_]/g, "_");
+    return `prop_${sanitized}`;
+}
+/**
+ * Builds a mapping of original property names to sanitized versions
+ * suitable for use as JavaScript function parameters.
+ */
+export function buildPropertyMapping(properties) {
+    const mapping = new Map();
+    for (const prop of properties) {
+        mapping.set(prop, sanitizePropertyName(prop));
+    }
+    return mapping;
+}
+/**
+ * Replaces property names in an expression with their sanitized versions.
+ * Sorts by length descending to replace longer property names first and avoid partial matches.
+ */
+export function sanitizeExpression(expression, propertyMapping) {
+    let sanitized = expression;
+    // Sort by length descending to replace longer property names first
+    const sortedEntries = Array.from(propertyMapping.entries()).sort(([a], [b]) => b.length - a.length);
+    for (const [original, sanitizedName] of sortedEntries) {
+        if (original !== sanitizedName) {
+            const escaped = original.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+            // Use a regex that matches the property name not preceded or followed by word characters
+            // This allows matching properties with special characters like "My-Property"
+            const regex = new RegExp(`(?<!\\w)${escaped}(?!\\w)`, "g");
+            sanitized = sanitized.replace(regex, sanitizedName);
+        }
+    }
+    return sanitized;
+}
+//# sourceMappingURL=expression-utils.js.map

package/dist/core/expression-utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"expression-utils.js","sourceRoot":"","sources":["../../src/core/expression-utils.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,UAAU,oBAAoB,CAAC,IAAY;IAChD,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,gBAAgB,EAAE,GAAG,CAAC,CAAC;IACtD,OAAO,QAAQ,SAAS,EAAE,CAAC;AAC5B,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,oBAAoB,CAAC,UAAoB;IACxD,MAAM,OAAO,GAAG,IAAI,GAAG,EAAkB,CAAC;IAE1C,KAAK,MAAM,IAAI,IAAI,UAAU,EAAE,CAAC;QAC/B,OAAO,CAAC,GAAG,CAAC,IAAI,EAAE,oBAAoB,CAAC,IAAI,CAAC,CAAC,CAAC;IAC/C,CAAC;IAED,OAAO,OAAO,CAAC;AAChB,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,kBAAkB,CACjC,UAAkB,EAClB,eAAoC;IAEpC,IAAI,SAAS,GAAG,UAAU,CAAC;IAE3B,mEAAmE;IACnE,MAAM,aAAa,GAAG,KAAK,CAAC,IAAI,CAAC,eAAe,CAAC,OAAO,EAAE,CAAC,CAAC,IAAI,CAC/D,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,MAAM,CACjC,CAAC;IAEF,KAAK,MAAM,CAAC,QAAQ,EAAE,aAAa,CAAC,IAAI,aAAa,EAAE,CAAC;QACvD,IAAI,QAAQ,KAAK,aAAa,EAAE,CAAC;YAChC,MAAM,OAAO,GAAG,QAAQ,CAAC,OAAO,CAAC,qBAAqB,EAAE,MAAM,CAAC,CAAC;YAEhE,yFAAyF;YACzF,6EAA6E;YAC7E,MAAM,KAAK,GAAG,IAAI,MAAM,CAAC,WAAW,OAAO,SAAS,EAAE,GAAG,CAAC,CAAC;YAE3D,SAAS,GAAG,SAAS,CAAC,OAAO,CAAC,KAAK,EAAE,aAAa,CAAC,CAAC;QACrD,CAAC;IACF,CAAC;IAED,OAAO,SAAS,CAAC;AAClB,CAAC","sourcesContent":["/**\n * Sanitizes a property name for use as a JavaScript function parameter\n * by replacing spaces and special characters with underscores.\n * Adds a prefix to avoid conflicts with JavaScript reserved words.\n */\nexport function sanitizePropertyName(name: string): string {\n\tconst sanitized = name.replace(/[^a-zA-Z0-9_]/g, \"_\");\n\treturn `prop_${sanitized}`;\n}\n\n/**\n * Builds a mapping of original property names to sanitized versions\n * suitable for use as JavaScript function parameters.\n */\nexport function buildPropertyMapping(properties: string[]): Map<string, string> {\n\tconst mapping = new Map<string, string>();\n\n\tfor (const prop of properties) {\n\t\tmapping.set(prop, sanitizePropertyName(prop));\n\t}\n\n\treturn mapping;\n}\n\n/**\n * Replaces property names in an expression with their sanitized versions.\n * Sorts by length descending to replace longer property names first and avoid partial matches.\n */\nexport function sanitizeExpression(\n\texpression: string,\n\tpropertyMapping: Map<string, string>\n): string {\n\tlet sanitized = expression;\n\n\t// Sort by length descending to replace longer property names first\n\tconst sortedEntries = Array.from(propertyMapping.entries()).sort(\n\t\t([a], [b]) => b.length - a.length\n\t);\n\n\tfor (const [original, sanitizedName] of sortedEntries) {\n\t\tif (original !== sanitizedName) {\n\t\t\tconst escaped = original.replace(/[.*+?^${}()|[\\]\\\\]/g, \"\\\\$&\");\n\n\t\t\t// Use a regex that matches the property name not preceded or followed by word characters\n\t\t\t// This allows matching properties with special characters like \"My-Property\"\n\t\t\tconst regex = new RegExp(`(?<!\\\\w)${escaped}(?!\\\\w)`, \"g\");\n\n\t\t\tsanitized = sanitized.replace(regex, sanitizedName);\n\t\t}\n\t}\n\n\treturn sanitized;\n}\n"]}

package/dist/core/frontmatter-value.d.ts

@@ -0,0 +1,143 @@
+export declare function isEmptyValue(value: unknown): boolean;
+/**
+ * Serializes a frontmatter value to a string for editing in input fields.
+ * Arrays are joined with ", " for easier editing.
+ */
+export declare function serializeValue(value: unknown): string;
+/**
+ * Parses a string value from an input field into the appropriate type.
+ * Handles: booleans, numbers, JSON objects/arrays, comma-separated arrays, and strings.
+ */
+export declare function parseValue(rawValue: string): unknown;
+/**
+ * Formats a frontmatter value for display in read-only contexts.
+ * Converts booleans to "Yes"/"No", numbers to strings, and objects to JSON.
+ */
+export declare function formatValue(value: unknown): string;
+/**
+ * Parses wiki link syntax from a string value.
+ * Supports both [[path]] and [[path|alias]] formats.
+ * Returns null if the string is not a wiki link.
+ */
+export declare function parseWikiLinkWithDisplay(value: string): {
+    linkPath: string;
+    displayText: string;
+} | null;
+/**
+ * Normalizes frontmatter property values to an array of strings.
+ * Handles various YAML formats and ensures consistent output.
+ *
+ * @param value - The raw frontmatter property value (can be any type)
+ * @param propertyName - Optional property name for logging purposes
+ * @returns Array of strings, or empty array if value is invalid/unexpected
+ *
+ * @example
+ * // Single string value
+ * normalizeProperty("[[link]]") // ["[[link]]"]
+ *
+ * // Array of strings
+ * normalizeProperty(["[[link1]]", "[[link2]]"]) // ["[[link1]]", "[[link2]]"]
+ *
+ * // Mixed array (filters out non-strings)
+ * normalizeProperty(["[[link]]", 42, null]) // ["[[link]]"]
+ *
+ * // Invalid types
+ * normalizeProperty(null) // []
+ * normalizeProperty(undefined) // []
+ * normalizeProperty(42) // []
+ * normalizeProperty({}) // []
+ */
+export declare function normalizeProperty(value: unknown, propertyName?: string): string[];
+/**
+ * Batch normalize multiple property values from frontmatter.
+ * Useful for processing multiple properties at once.
+ *
+ * @param frontmatter - The frontmatter object
+ * @param propertyNames - Array of property names to normalize
+ * @returns Map of property names to normalized string arrays
+ *
+ * @example
+ * const frontmatter = {
+ *   parent: "[[Parent]]",
+ *   children: ["[[Child1]]", "[[Child2]]"],
+ *   related: null
+ * };
+ *
+ * const normalized = normalizeProperties(frontmatter, ["parent", "children", "related"]);
+ * // Map {
+ * //   "parent" => ["[[Parent]]"],
+ * //   "children" => ["[[Child1]]", "[[Child2]]"],
+ * //   "related" => []
+ * // }
+ */
+export declare function normalizeProperties(frontmatter: Record<string, unknown>, propertyNames: string[]): Map<string, string[]>;
+/**
+ * Truncates a string to a maximum length, adding ellipsis if needed.
+ */
+export declare function truncateString(text: string, maxLength: number): string;
+/**
+ * Removes wiki link syntax from a string for cleaner display.
+ * Converts [[Link|Alias]] to just "Link" or [[Link]] to "Link".
+ */
+export declare function removeWikiLinks(text: string): string;
+/**
+ * Formats an array as a compact comma-separated string with smart truncation.
+ * Shows "item1, item2, +3" if the full list would exceed maxLength.
+ */
+export declare function formatArrayCompact(items: string[], maxLength: number): string;
+export interface DisplaySettings {
+    hideUnderscoreProperties?: boolean;
+    hideEmptyProperties?: boolean;
+}
+/**
+ * Filters frontmatter properties based on display settings.
+ * Returns an array of [key, value] pairs that should be displayed.
+ */
+export declare function filterPropertiesForDisplay<TSettings extends DisplaySettings>(frontmatter: Record<string, unknown>, settings: TSettings): Array<[string, unknown]>;
+/**
+ * Filters a specific list of property names from frontmatter.
+ * Useful when you want to display only specific properties (like in tooltips).
+ */
+export declare function filterSpecificProperties<TSettings extends DisplaySettings>(frontmatter: Record<string, unknown>, propertyNames: string[], settings: TSettings): Array<{
+    key: string;
+    value: unknown;
+}>;
+export interface WikiLinkSegment {
+    type: "text" | "link";
+    content: string;
+    linkPath?: string;
+    displayText?: string;
+}
+/**
+ * Parses a string containing inline wiki links into segments.
+ * Useful for rendering strings with clickable wiki links mixed with regular text.
+ *
+ * @example
+ * parseInlineWikiLinks("Visit [[Page1]] and [[Page2|Second Page]]")
+ * // Returns:
+ * // [
+ * //   { type: "text", content: "Visit " },
+ * //   { type: "link", content: "[[Page1]]", linkPath: "Page1", displayText: "Page1" },
+ * //   { type: "text", content: " and " },
+ * //   { type: "link", content: "[[Page2|Second Page]]", linkPath: "Page2", displayText: "Second Page" }
+ * // ]
+ */
+export declare function parseInlineWikiLinks(text: string): WikiLinkSegment[];
+/**
+ * Formats a frontmatter value for compact display inside graph nodes.
+ * Truncates long values and handles arrays gracefully.
+ *
+ * @param value - The frontmatter value to format
+ * @param maxLength - Maximum length before truncation (default: 20)
+ * @returns Formatted string suitable for node display
+ *
+ * @example
+ * formatValueForNode("completed") // "completed"
+ * formatValueForNode("A very long string that exceeds the limit") // "A very long string..."
+ * formatValueForNode(["tag1", "tag2", "tag3"]) // "tag1, tag2, tag3"
+ * formatValueForNode(["tag1", "tag2", "tag3", "tag4", "tag5"], 15) // "tag1, tag2, +3"
+ * formatValueForNode(true) // "Yes"
+ * formatValueForNode(42) // "42"
+ */
+export declare function formatValueForNode(value: unknown, maxLength?: number): string;
+//# sourceMappingURL=frontmatter-value.d.ts.map