@real1ty-obsidian-plugins/utils 2.5.0 → 2.7.0

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

@@ -1 +1 @@
-{"version":3,"file":"filter.d.ts","sourceRoot":"","sources":["../../../src/core/evaluator/filter.ts"],"names":[],"mappings":"AAEA,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"}
+{"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.map

@@ -1 +1 @@
-{"version":3,"file":"filter.js","sourceRoot":"","sources":["../../../src/core/evaluator/filter.ts"],"names":[],"mappings":"AAEA,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 type { BehaviorSubject } from \"rxjs\";\n\nimport { 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"]}
+{"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/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

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

@@ -0,0 +1 @@
+{"version":3,"file":"frontmatter-value.d.ts","sourceRoot":"","sources":["../../src/core/frontmatter-value.ts"],"names":[],"mappings":"AAIA,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAcpD;AAMD;;;GAGG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAcrD;AAED;;;GAGG;AACH,wBAAgB,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CA8CpD;AAMD;;;GAGG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAclD;AAMD;;;;GAIG;AACH,wBAAgB,wBAAwB,CACvC,KAAK,EAAE,MAAM,GACX;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAelD;AAMD;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,EAAE,YAAY,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAqDjF;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,mBAAmB,CAClC,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACpC,aAAa,EAAE,MAAM,EAAE,GACrB,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CASvB;AAMD;;GAEG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAEtE;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEpD;AAMD;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAkC7E;AAMD,MAAM,WAAW,eAAe;IAC/B,wBAAwB,CAAC,EAAE,OAAO,CAAC;IACnC,mBAAmB,CAAC,EAAE,OAAO,CAAC;CAC9B;AAED;;;GAGG;AACH,wBAAgB,0BAA0B,CAAC,SAAS,SAAS,eAAe,EAC3E,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACpC,QAAQ,EAAE,SAAS,GACjB,KAAK,CAAC,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAgB1B;AAED;;;GAGG;AACH,wBAAgB,wBAAwB,CAAC,SAAS,SAAS,eAAe,EACzE,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACpC,aAAa,EAAE,MAAM,EAAE,EACvB,QAAQ,EAAE,SAAS,GACjB,KAAK,CAAC;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,OAAO,CAAA;CAAE,CAAC,CAyBxC;AAMD,MAAM,WAAW,eAAe;IAC/B,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC;IACtB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,eAAe,EAAE,CA+CpE;AAMD;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,OAAO,EAAE,SAAS,SAAK,GAAG,MAAM,CAkCzE"}

package/dist/core/frontmatter-value.js

@@ -0,0 +1,408 @@
+// ============================================================================
+// Value Checking
+// ============================================================================
+export function isEmptyValue(value) {
+    if (value === null || value === undefined) {
+        return true;
+    }
+    if (typeof value === "string" && value.trim() === "") {
+        return true;
+    }
+    if (Array.isArray(value) && value.length === 0) {
+        return true;
+    }
+    return false;
+}
+// ============================================================================
+// Value Serialization & Parsing (for editing in input fields)
+// ============================================================================
+/**
+ * Serializes a frontmatter value to a string for editing in input fields.
+ * Arrays are joined with ", " for easier editing.
+ */
+export function serializeValue(value) {
+    if (value === null || value === undefined) {
+        return "";
+    }
+    if (Array.isArray(value)) {
+        return value.map((item) => serializeValue(item)).join(", ");
+    }
+    if (typeof value === "object") {
+        return JSON.stringify(value);
+    }
+    return String(value);
+}
+/**
+ * Parses a string value from an input field into the appropriate type.
+ * Handles: booleans, numbers, JSON objects/arrays, comma-separated arrays, and strings.
+ */
+export function parseValue(rawValue) {
+    const trimmed = rawValue.trim();
+    if (trimmed === "") {
+        return "";
+    }
+    // Parse boolean
+    if (trimmed.toLowerCase() === "true") {
+        return true;
+    }
+    if (trimmed.toLowerCase() === "false") {
+        return false;
+    }
+    // Parse number
+    if (/^-?\d+(\.\d+)?$/.test(trimmed)) {
+        const num = Number(trimmed);
+        if (!Number.isNaN(num)) {
+            return num;
+        }
+    }
+    // Parse JSON object or array (check BEFORE comma-separated arrays)
+    if ((trimmed.startsWith("{") && trimmed.endsWith("}")) ||
+        (trimmed.startsWith("[") && trimmed.endsWith("]"))) {
+        try {
+            return JSON.parse(trimmed);
+        }
+        catch (_a) {
+            // If parsing fails, continue to other checks
+        }
+    }
+    // Parse comma-separated array
+    if (trimmed.includes(",")) {
+        const items = trimmed.split(",").map((item) => item.trim());
+        if (items.every((item) => item.length > 0)) {
+            return items;
+        }
+    }
+    // Default: return as string
+    return trimmed;
+}
+// ============================================================================
+// Value Formatting (for display in read-only contexts)
+// ============================================================================
+/**
+ * Formats a frontmatter value for display in read-only contexts.
+ * Converts booleans to "Yes"/"No", numbers to strings, and objects to JSON.
+ */
+export function formatValue(value) {
+    if (typeof value === "boolean") {
+        return value ? "Yes" : "No";
+    }
+    if (typeof value === "number") {
+        return value.toString();
+    }
+    if (typeof value === "object" && value !== null) {
+        return JSON.stringify(value, null, 2);
+    }
+    return String(value);
+}
+// ============================================================================
+// Wiki Link Parsing
+// ============================================================================
+/**
+ * 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 function parseWikiLinkWithDisplay(value) {
+    const wikiLinkMatch = value.match(/^\[\[([^\]]*)\]\]$/);
+    if (!wikiLinkMatch) {
+        return null;
+    }
+    const innerContent = wikiLinkMatch[1];
+    const pipeIndex = innerContent.indexOf("|");
+    const linkPath = pipeIndex !== -1 ? innerContent.substring(0, pipeIndex).trim() : innerContent.trim();
+    const displayText = pipeIndex !== -1 ? innerContent.substring(pipeIndex + 1).trim() : linkPath;
+    return { linkPath, displayText };
+}
+// ============================================================================
+// Property Normalization
+// ============================================================================
+/**
+ * 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 function normalizeProperty(value, propertyName) {
+    // Handle undefined and null
+    if (value === undefined || value === null) {
+        return [];
+    }
+    // Handle string values - convert to single-item array
+    if (typeof value === "string") {
+        // Empty strings should return empty array
+        if (value.trim() === "") {
+            return [];
+        }
+        return [value];
+    }
+    // Handle array values
+    if (Array.isArray(value)) {
+        // Empty arrays
+        if (value.length === 0) {
+            return [];
+        }
+        // Filter to only string values
+        const stringValues = value.filter((item) => {
+            if (typeof item === "string") {
+                return true;
+            }
+            // Log warning for non-string items
+            if (propertyName) {
+                console.warn(`Property "${propertyName}" contains non-string value (${typeof item}), filtering it out:`, item);
+            }
+            return false;
+        });
+        // Filter out empty strings
+        const nonEmptyStrings = stringValues.filter((s) => s.trim() !== "");
+        return nonEmptyStrings;
+    }
+    // Handle unexpected types (numbers, booleans, objects, etc.)
+    if (propertyName) {
+        console.warn(`Property "${propertyName}" has unexpected type (${typeof value}), returning empty array. Value:`, value);
+    }
+    return [];
+}
+/**
+ * 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 function normalizeProperties(frontmatter, propertyNames) {
+    const result = new Map();
+    for (const propName of propertyNames) {
+        const value = frontmatter[propName];
+        result.set(propName, normalizeProperty(value, propName));
+    }
+    return result;
+}
+// ============================================================================
+// String Utilities
+// ============================================================================
+/**
+ * Truncates a string to a maximum length, adding ellipsis if needed.
+ */
+export function truncateString(text, maxLength) {
+    return text.length > maxLength ? `${text.substring(0, maxLength)}...` : text;
+}
+/**
+ * Removes wiki link syntax from a string for cleaner display.
+ * Converts [[Link|Alias]] to just "Link" or [[Link]] to "Link".
+ */
+export function removeWikiLinks(text) {
+    return text.replace(/\[\[([^\]|]+)(?:\|[^\]]+)?\]\]/g, "$1");
+}
+// ============================================================================
+// Array Formatting Utilities
+// ============================================================================
+/**
+ * Formats an array as a compact comma-separated string with smart truncation.
+ * Shows "item1, item2, +3" if the full list would exceed maxLength.
+ */
+export function formatArrayCompact(items, maxLength) {
+    if (items.length === 0) {
+        return "";
+    }
+    // Single item - just truncate it
+    if (items.length === 1) {
+        return truncateString(items[0], maxLength);
+    }
+    const joined = items.join(", ");
+    // Fits within limit - return as is
+    if (joined.length <= maxLength) {
+        return joined;
+    }
+    // Too long - show first few items + count
+    let result = "";
+    let count = 0;
+    for (const item of items) {
+        const testResult = result ? `${result}, ${item}` : item;
+        if (testResult.length > maxLength - 5) {
+            const remaining = items.length - count;
+            return `${result}${remaining > 0 ? `, +${remaining}` : ""}`;
+        }
+        result = testResult;
+        count++;
+    }
+    return result;
+}
+/**
+ * Filters frontmatter properties based on display settings.
+ * Returns an array of [key, value] pairs that should be displayed.
+ */
+export function filterPropertiesForDisplay(frontmatter, settings) {
+    const entries = Object.entries(frontmatter);
+    return entries.filter(([key, value]) => {
+        // Hide underscore properties if configured
+        if (settings.hideUnderscoreProperties && key.startsWith("_")) {
+            return false;
+        }
+        // Hide empty properties if configured
+        if (settings.hideEmptyProperties && isEmptyValue(value)) {
+            return false;
+        }
+        return true;
+    });
+}
+/**
+ * Filters a specific list of property names from frontmatter.
+ * Useful when you want to display only specific properties (like in tooltips).
+ */
+export function filterSpecificProperties(frontmatter, propertyNames, settings) {
+    const result = [];
+    for (const propName of propertyNames) {
+        // Skip if property doesn't exist in frontmatter
+        if (!(propName in frontmatter)) {
+            continue;
+        }
+        const value = frontmatter[propName];
+        // Hide underscore properties if configured
+        if (settings.hideUnderscoreProperties && propName.startsWith("_")) {
+            continue;
+        }
+        // Hide empty properties if configured
+        if (settings.hideEmptyProperties && isEmptyValue(value)) {
+            continue;
+        }
+        result.push({ key: propName, value });
+    }
+    return result;
+}
+/**
+ * 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 function parseInlineWikiLinks(text) {
+    var _a;
+    const segments = [];
+    const wikiLinkRegex = /\[\[([^\]|]+)(?:\|([^\]]+))?\]\]/g;
+    let lastIndex = 0;
+    const matches = text.matchAll(wikiLinkRegex);
+    for (const match of matches) {
+        // Add text before the link
+        if (match.index !== undefined && match.index > lastIndex) {
+            segments.push({
+                type: "text",
+                content: text.substring(lastIndex, match.index),
+            });
+        }
+        // Add the link segment
+        const linkPath = match[1];
+        const displayText = match[2] || linkPath;
+        segments.push({
+            type: "link",
+            content: match[0],
+            linkPath,
+            displayText,
+        });
+        lastIndex = ((_a = match.index) !== null && _a !== void 0 ? _a : 0) + match[0].length;
+    }
+    // Add remaining text
+    if (lastIndex < text.length) {
+        segments.push({
+            type: "text",
+            content: text.substring(lastIndex),
+        });
+    }
+    // If no links found, return the entire text as a single segment
+    if (segments.length === 0) {
+        segments.push({
+            type: "text",
+            content: text,
+        });
+    }
+    return segments;
+}
+// ============================================================================
+// Node Display Formatting
+// ============================================================================
+/**
+ * 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 function formatValueForNode(value, maxLength = 20) {
+    if (isEmptyValue(value)) {
+        return "";
+    }
+    // Booleans: reuse formatValue logic
+    if (typeof value === "boolean") {
+        return value ? "Yes" : "No";
+    }
+    // Numbers: reuse formatValue logic
+    if (typeof value === "number") {
+        return value.toString();
+    }
+    // Arrays: extract strings and format compactly
+    if (Array.isArray(value)) {
+        const stringValues = value.filter((item) => typeof item === "string");
+        return formatArrayCompact(stringValues, maxLength);
+    }
+    // Strings: clean wiki links and truncate
+    if (typeof value === "string") {
+        const cleaned = removeWikiLinks(value);
+        return truncateString(cleaned, maxLength);
+    }
+    // Objects: stringify and truncate
+    if (typeof value === "object" && value !== null) {
+        const jsonStr = JSON.stringify(value);
+        return truncateString(jsonStr, maxLength);
+    }
+    return String(value);
+}
+//# sourceMappingURL=frontmatter-value.js.map

package/dist/core/frontmatter-value.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"frontmatter-value.js","sourceRoot":"","sources":["../../src/core/frontmatter-value.ts"],"names":[],"mappings":"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","sourcesContent":["// ============================================================================\n// Value Checking\n// ============================================================================\n\nexport function isEmptyValue(value: unknown): boolean {\n\tif (value === null || value === undefined) {\n\t\treturn true;\n\t}\n\n\tif (typeof value === \"string\" && value.trim() === \"\") {\n\t\treturn true;\n\t}\n\n\tif (Array.isArray(value) && value.length === 0) {\n\t\treturn true;\n\t}\n\n\treturn false;\n}\n\n// ============================================================================\n// Value Serialization & Parsing (for editing in input fields)\n// ============================================================================\n\n/**\n * Serializes a frontmatter value to a string for editing in input fields.\n * Arrays are joined with \", \" for easier editing.\n */\nexport function serializeValue(value: unknown): string {\n\tif (value === null || value === undefined) {\n\t\treturn \"\";\n\t}\n\n\tif (Array.isArray(value)) {\n\t\treturn value.map((item) => serializeValue(item)).join(\", \");\n\t}\n\n\tif (typeof value === \"object\") {\n\t\treturn JSON.stringify(value);\n\t}\n\n\treturn String(value);\n}\n\n/**\n * Parses a string value from an input field into the appropriate type.\n * Handles: booleans, numbers, JSON objects/arrays, comma-separated arrays, and strings.\n */\nexport function parseValue(rawValue: string): unknown {\n\tconst trimmed = rawValue.trim();\n\n\tif (trimmed === \"\") {\n\t\treturn \"\";\n\t}\n\n\t// Parse boolean\n\tif (trimmed.toLowerCase() === \"true\") {\n\t\treturn true;\n\t}\n\tif (trimmed.toLowerCase() === \"false\") {\n\t\treturn false;\n\t}\n\n\t// Parse number\n\tif (/^-?\\d+(\\.\\d+)?$/.test(trimmed)) {\n\t\tconst num = Number(trimmed);\n\t\tif (!Number.isNaN(num)) {\n\t\t\treturn num;\n\t\t}\n\t}\n\n\t// Parse JSON object or array (check BEFORE comma-separated arrays)\n\tif (\n\t\t(trimmed.startsWith(\"{\") && trimmed.endsWith(\"}\")) ||\n\t\t(trimmed.startsWith(\"[\") && trimmed.endsWith(\"]\"))\n\t) {\n\t\ttry {\n\t\t\treturn JSON.parse(trimmed);\n\t\t} catch {\n\t\t\t// If parsing fails, continue to other checks\n\t\t}\n\t}\n\n\t// Parse comma-separated array\n\tif (trimmed.includes(\",\")) {\n\t\tconst items = trimmed.split(\",\").map((item) => item.trim());\n\n\t\tif (items.every((item) => item.length > 0)) {\n\t\t\treturn items;\n\t\t}\n\t}\n\n\t// Default: return as string\n\treturn trimmed;\n}\n\n// ============================================================================\n// Value Formatting (for display in read-only contexts)\n// ============================================================================\n\n/**\n * Formats a frontmatter value for display in read-only contexts.\n * Converts booleans to \"Yes\"/\"No\", numbers to strings, and objects to JSON.\n */\nexport function formatValue(value: unknown): string {\n\tif (typeof value === \"boolean\") {\n\t\treturn value ? \"Yes\" : \"No\";\n\t}\n\n\tif (typeof value === \"number\") {\n\t\treturn value.toString();\n\t}\n\n\tif (typeof value === \"object\" && value !== null) {\n\t\treturn JSON.stringify(value, null, 2);\n\t}\n\n\treturn String(value);\n}\n\n// ============================================================================\n// Wiki Link Parsing\n// ============================================================================\n\n/**\n * Parses wiki link syntax from a string value.\n * Supports both [[path]] and [[path|alias]] formats.\n * Returns null if the string is not a wiki link.\n */\nexport function parseWikiLinkWithDisplay(\n\tvalue: string\n): { linkPath: string; displayText: string } | null {\n\tconst wikiLinkMatch = value.match(/^\\[\\[([^\\]]*)\\]\\]$/);\n\tif (!wikiLinkMatch) {\n\t\treturn null;\n\t}\n\n\tconst innerContent = wikiLinkMatch[1];\n\tconst pipeIndex = innerContent.indexOf(\"|\");\n\n\tconst linkPath =\n\t\tpipeIndex !== -1 ? innerContent.substring(0, pipeIndex).trim() : innerContent.trim();\n\n\tconst displayText = pipeIndex !== -1 ? innerContent.substring(pipeIndex + 1).trim() : linkPath;\n\n\treturn { linkPath, displayText };\n}\n\n// ============================================================================\n// Property Normalization\n// ============================================================================\n\n/**\n * Normalizes frontmatter property values to an array of strings.\n * Handles various YAML formats and ensures consistent output.\n *\n * @param value - The raw frontmatter property value (can be any type)\n * @param propertyName - Optional property name for logging purposes\n * @returns Array of strings, or empty array if value is invalid/unexpected\n *\n * @example\n * // Single string value\n * normalizeProperty(\"[[link]]\") // [\"[[link]]\"]\n *\n * // Array of strings\n * normalizeProperty([\"[[link1]]\", \"[[link2]]\"]) // [\"[[link1]]\", \"[[link2]]\"]\n *\n * // Mixed array (filters out non-strings)\n * normalizeProperty([\"[[link]]\", 42, null]) // [\"[[link]]\"]\n *\n * // Invalid types\n * normalizeProperty(null) // []\n * normalizeProperty(undefined) // []\n * normalizeProperty(42) // []\n * normalizeProperty({}) // []\n */\nexport function normalizeProperty(value: unknown, propertyName?: string): string[] {\n\t// Handle undefined and null\n\tif (value === undefined || value === null) {\n\t\treturn [];\n\t}\n\n\t// Handle string values - convert to single-item array\n\tif (typeof value === \"string\") {\n\t\t// Empty strings should return empty array\n\t\tif (value.trim() === \"\") {\n\t\t\treturn [];\n\t\t}\n\t\treturn [value];\n\t}\n\n\t// Handle array values\n\tif (Array.isArray(value)) {\n\t\t// Empty arrays\n\t\tif (value.length === 0) {\n\t\t\treturn [];\n\t\t}\n\n\t\t// Filter to only string values\n\t\tconst stringValues = value.filter((item): item is string => {\n\t\t\tif (typeof item === \"string\") {\n\t\t\t\treturn true;\n\t\t\t}\n\n\t\t\t// Log warning for non-string items\n\t\t\tif (propertyName) {\n\t\t\t\tconsole.warn(\n\t\t\t\t\t`Property \"${propertyName}\" contains non-string value (${typeof item}), filtering it out:`,\n\t\t\t\t\titem\n\t\t\t\t);\n\t\t\t}\n\t\t\treturn false;\n\t\t});\n\n\t\t// Filter out empty strings\n\t\tconst nonEmptyStrings = stringValues.filter((s) => s.trim() !== \"\");\n\n\t\treturn nonEmptyStrings;\n\t}\n\n\t// Handle unexpected types (numbers, booleans, objects, etc.)\n\tif (propertyName) {\n\t\tconsole.warn(\n\t\t\t`Property \"${propertyName}\" has unexpected type (${typeof value}), returning empty array. Value:`,\n\t\t\tvalue\n\t\t);\n\t}\n\n\treturn [];\n}\n\n/**\n * Batch normalize multiple property values from frontmatter.\n * Useful for processing multiple properties at once.\n *\n * @param frontmatter - The frontmatter object\n * @param propertyNames - Array of property names to normalize\n * @returns Map of property names to normalized string arrays\n *\n * @example\n * const frontmatter = {\n *   parent: \"[[Parent]]\",\n *   children: [\"[[Child1]]\", \"[[Child2]]\"],\n *   related: null\n * };\n *\n * const normalized = normalizeProperties(frontmatter, [\"parent\", \"children\", \"related\"]);\n * // Map {\n * //   \"parent\" => [\"[[Parent]]\"],\n * //   \"children\" => [\"[[Child1]]\", \"[[Child2]]\"],\n * //   \"related\" => []\n * // }\n */\nexport function normalizeProperties(\n\tfrontmatter: Record<string, unknown>,\n\tpropertyNames: string[]\n): Map<string, string[]> {\n\tconst result = new Map<string, string[]>();\n\n\tfor (const propName of propertyNames) {\n\t\tconst value = frontmatter[propName];\n\t\tresult.set(propName, normalizeProperty(value, propName));\n\t}\n\n\treturn result;\n}\n\n// ============================================================================\n// String Utilities\n// ============================================================================\n\n/**\n * Truncates a string to a maximum length, adding ellipsis if needed.\n */\nexport function truncateString(text: string, maxLength: number): string {\n\treturn text.length > maxLength ? `${text.substring(0, maxLength)}...` : text;\n}\n\n/**\n * Removes wiki link syntax from a string for cleaner display.\n * Converts [[Link|Alias]] to just \"Link\" or [[Link]] to \"Link\".\n */\nexport function removeWikiLinks(text: string): string {\n\treturn text.replace(/\\[\\[([^\\]|]+)(?:\\|[^\\]]+)?\\]\\]/g, \"$1\");\n}\n\n// ============================================================================\n// Array Formatting Utilities\n// ============================================================================\n\n/**\n * Formats an array as a compact comma-separated string with smart truncation.\n * Shows \"item1, item2, +3\" if the full list would exceed maxLength.\n */\nexport function formatArrayCompact(items: string[], maxLength: number): string {\n\tif (items.length === 0) {\n\t\treturn \"\";\n\t}\n\n\t// Single item - just truncate it\n\tif (items.length === 1) {\n\t\treturn truncateString(items[0], maxLength);\n\t}\n\n\tconst joined = items.join(\", \");\n\n\t// Fits within limit - return as is\n\tif (joined.length <= maxLength) {\n\t\treturn joined;\n\t}\n\n\t// Too long - show first few items + count\n\tlet result = \"\";\n\tlet count = 0;\n\n\tfor (const item of items) {\n\t\tconst testResult = result ? `${result}, ${item}` : item;\n\n\t\tif (testResult.length > maxLength - 5) {\n\t\t\tconst remaining = items.length - count;\n\t\t\treturn `${result}${remaining > 0 ? `, +${remaining}` : \"\"}`;\n\t\t}\n\n\t\tresult = testResult;\n\t\tcount++;\n\t}\n\n\treturn result;\n}\n\n// ============================================================================\n// Property Filtering (Generic over Settings)\n// ============================================================================\n\nexport interface DisplaySettings {\n\thideUnderscoreProperties?: boolean;\n\thideEmptyProperties?: boolean;\n}\n\n/**\n * Filters frontmatter properties based on display settings.\n * Returns an array of [key, value] pairs that should be displayed.\n */\nexport function filterPropertiesForDisplay<TSettings extends DisplaySettings>(\n\tfrontmatter: Record<string, unknown>,\n\tsettings: TSettings\n): Array<[string, unknown]> {\n\tconst entries = Object.entries(frontmatter);\n\n\treturn entries.filter(([key, value]) => {\n\t\t// Hide underscore properties if configured\n\t\tif (settings.hideUnderscoreProperties && key.startsWith(\"_\")) {\n\t\t\treturn false;\n\t\t}\n\n\t\t// Hide empty properties if configured\n\t\tif (settings.hideEmptyProperties && isEmptyValue(value)) {\n\t\t\treturn false;\n\t\t}\n\n\t\treturn true;\n\t});\n}\n\n/**\n * Filters a specific list of property names from frontmatter.\n * Useful when you want to display only specific properties (like in tooltips).\n */\nexport function filterSpecificProperties<TSettings extends DisplaySettings>(\n\tfrontmatter: Record<string, unknown>,\n\tpropertyNames: string[],\n\tsettings: TSettings\n): Array<{ key: string; value: unknown }> {\n\tconst result: Array<{ key: string; value: unknown }> = [];\n\n\tfor (const propName of propertyNames) {\n\t\t// Skip if property doesn't exist in frontmatter\n\t\tif (!(propName in frontmatter)) {\n\t\t\tcontinue;\n\t\t}\n\n\t\tconst value = frontmatter[propName];\n\n\t\t// Hide underscore properties if configured\n\t\tif (settings.hideUnderscoreProperties && propName.startsWith(\"_\")) {\n\t\t\tcontinue;\n\t\t}\n\n\t\t// Hide empty properties if configured\n\t\tif (settings.hideEmptyProperties && isEmptyValue(value)) {\n\t\t\tcontinue;\n\t\t}\n\n\t\tresult.push({ key: propName, value });\n\t}\n\n\treturn result;\n}\n\n// ============================================================================\n// Inline Wiki Link Parsing\n// ============================================================================\n\nexport interface WikiLinkSegment {\n\ttype: \"text\" | \"link\";\n\tcontent: string;\n\tlinkPath?: string;\n\tdisplayText?: string;\n}\n\n/**\n * Parses a string containing inline wiki links into segments.\n * Useful for rendering strings with clickable wiki links mixed with regular text.\n *\n * @example\n * parseInlineWikiLinks(\"Visit [[Page1]] and [[Page2|Second Page]]\")\n * // Returns:\n * // [\n * //   { type: \"text\", content: \"Visit \" },\n * //   { type: \"link\", content: \"[[Page1]]\", linkPath: \"Page1\", displayText: \"Page1\" },\n * //   { type: \"text\", content: \" and \" },\n * //   { type: \"link\", content: \"[[Page2|Second Page]]\", linkPath: \"Page2\", displayText: \"Second Page\" }\n * // ]\n */\nexport function parseInlineWikiLinks(text: string): WikiLinkSegment[] {\n\tconst segments: WikiLinkSegment[] = [];\n\tconst wikiLinkRegex = /\\[\\[([^\\]|]+)(?:\\|([^\\]]+))?\\]\\]/g;\n\tlet lastIndex = 0;\n\n\tconst matches = text.matchAll(wikiLinkRegex);\n\n\tfor (const match of matches) {\n\t\t// Add text before the link\n\t\tif (match.index !== undefined && match.index > lastIndex) {\n\t\t\tsegments.push({\n\t\t\t\ttype: \"text\",\n\t\t\t\tcontent: text.substring(lastIndex, match.index),\n\t\t\t});\n\t\t}\n\n\t\t// Add the link segment\n\t\tconst linkPath = match[1];\n\t\tconst displayText = match[2] || linkPath;\n\n\t\tsegments.push({\n\t\t\ttype: \"link\",\n\t\t\tcontent: match[0],\n\t\t\tlinkPath,\n\t\t\tdisplayText,\n\t\t});\n\n\t\tlastIndex = (match.index ?? 0) + match[0].length;\n\t}\n\n\t// Add remaining text\n\tif (lastIndex < text.length) {\n\t\tsegments.push({\n\t\t\ttype: \"text\",\n\t\t\tcontent: text.substring(lastIndex),\n\t\t});\n\t}\n\n\t// If no links found, return the entire text as a single segment\n\tif (segments.length === 0) {\n\t\tsegments.push({\n\t\t\ttype: \"text\",\n\t\t\tcontent: text,\n\t\t});\n\t}\n\n\treturn segments;\n}\n\n// ============================================================================\n// Node Display Formatting\n// ============================================================================\n\n/**\n * Formats a frontmatter value for compact display inside graph nodes.\n * Truncates long values and handles arrays gracefully.\n *\n * @param value - The frontmatter value to format\n * @param maxLength - Maximum length before truncation (default: 20)\n * @returns Formatted string suitable for node display\n *\n * @example\n * formatValueForNode(\"completed\") // \"completed\"\n * formatValueForNode(\"A very long string that exceeds the limit\") // \"A very long string...\"\n * formatValueForNode([\"tag1\", \"tag2\", \"tag3\"]) // \"tag1, tag2, tag3\"\n * formatValueForNode([\"tag1\", \"tag2\", \"tag3\", \"tag4\", \"tag5\"], 15) // \"tag1, tag2, +3\"\n * formatValueForNode(true) // \"Yes\"\n * formatValueForNode(42) // \"42\"\n */\nexport function formatValueForNode(value: unknown, maxLength = 20): string {\n\tif (isEmptyValue(value)) {\n\t\treturn \"\";\n\t}\n\n\t// Booleans: reuse formatValue logic\n\tif (typeof value === \"boolean\") {\n\t\treturn value ? \"Yes\" : \"No\";\n\t}\n\n\t// Numbers: reuse formatValue logic\n\tif (typeof value === \"number\") {\n\t\treturn value.toString();\n\t}\n\n\t// Arrays: extract strings and format compactly\n\tif (Array.isArray(value)) {\n\t\tconst stringValues = value.filter((item): item is string => typeof item === \"string\");\n\t\treturn formatArrayCompact(stringValues, maxLength);\n\t}\n\n\t// Strings: clean wiki links and truncate\n\tif (typeof value === \"string\") {\n\t\tconst cleaned = removeWikiLinks(value);\n\t\treturn truncateString(cleaned, maxLength);\n\t}\n\n\t// Objects: stringify and truncate\n\tif (typeof value === \"object\" && value !== null) {\n\t\tconst jsonStr = JSON.stringify(value);\n\t\treturn truncateString(jsonStr, maxLength);\n\t}\n\n\treturn String(value);\n}\n"]}

package/dist/core/index.d.ts

@@ -1,4 +1,5 @@
 export * from "./evaluator";
 export * from "./expression-utils";
+export * from "./frontmatter-value";
 export * from "./generate";
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/core/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,oBAAoB,CAAC;AACnC,cAAc,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/core/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,oBAAoB,CAAC;AACnC,cAAc,qBAAqB,CAAC;AACpC,cAAc,YAAY,CAAC"}

package/dist/core/index.js

@@ -1,4 +1,5 @@
 export * from "./evaluator";
 export * from "./expression-utils";
+export * from "./frontmatter-value";
 export * from "./generate";
 //# sourceMappingURL=index.js.map

package/dist/core/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/core/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,oBAAoB,CAAC;AACnC,cAAc,YAAY,CAAC","sourcesContent":["export * from \"./evaluator\";\nexport * from \"./expression-utils\";\nexport * from \"./generate\";\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/core/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,oBAAoB,CAAC;AACnC,cAAc,qBAAqB,CAAC;AACpC,cAAc,YAAY,CAAC","sourcesContent":["export * from \"./evaluator\";\nexport * from \"./expression-utils\";\nexport * from \"./frontmatter-value\";\nexport * from \"./generate\";\n"]}