@real1ty-obsidian-plugins/utils 2.30.0 → 2.31.0

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,157 @@
+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;
+export interface NormalizePropertyOptions {
+    /**
+     * Whether to log warnings for unexpected types.
+     * Default: false (silent mode)
+     */
+    logWarnings?: boolean;
+}
+/**
+ * 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
+ * @param options - Optional configuration for normalization behavior
+ * @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 silently)
+ * normalizeProperty(["[[link]]", 42, null]) // ["[[link]]"]
+ *
+ * // Mixed array with warnings enabled
+ * normalizeProperty(["[[link]]", 42], "myProp", { logWarnings: true })
+ * // Logs: Property "myProp" contains non-string value (number), filtering it out: 42
+ * // Returns: ["[[link]]"]
+ *
+ * // Invalid types
+ * normalizeProperty(null) // []
+ * normalizeProperty(undefined) // []
+ * normalizeProperty(42) // []
+ * normalizeProperty({}) // []
+ */
+export declare function normalizeProperty(value: unknown, propertyName?: string, options?: NormalizePropertyOptions): 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
+ * @param options - Optional configuration for normalization behavior
+ * @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[], options?: NormalizePropertyOptions): 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,MAAM,WAAW,wBAAwB;IACxC;;;OAGG;IACH,WAAW,CAAC,EAAE,OAAO,CAAC;CACtB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,wBAAgB,iBAAiB,CAChC,KAAK,EAAE,OAAO,EACd,YAAY,CAAC,EAAE,MAAM,EACrB,OAAO,CAAC,EAAE,wBAAwB,GAChC,MAAM,EAAE,CA4DV;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,mBAAmB,CAClC,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACpC,aAAa,EAAE,MAAM,EAAE,EACvB,OAAO,CAAC,EAAE,wBAAwB,GAChC,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,417 @@
+// ============================================================================
+// 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 };
+}
+/**
+ * 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
+ * @param options - Optional configuration for normalization behavior
+ * @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 silently)
+ * normalizeProperty(["[[link]]", 42, null]) // ["[[link]]"]
+ *
+ * // Mixed array with warnings enabled
+ * normalizeProperty(["[[link]]", 42], "myProp", { logWarnings: true })
+ * // Logs: Property "myProp" contains non-string value (number), filtering it out: 42
+ * // Returns: ["[[link]]"]
+ *
+ * // Invalid types
+ * normalizeProperty(null) // []
+ * normalizeProperty(undefined) // []
+ * normalizeProperty(42) // []
+ * normalizeProperty({}) // []
+ */
+export function normalizeProperty(value, propertyName, options) {
+    const { logWarnings = false } = options !== null && options !== void 0 ? options : {};
+    // 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;
+            }
+            // null and undefined are expected in YAML arrays, don't warn
+            if (item === null || item === undefined) {
+                return false;
+            }
+            // Log warning for truly unexpected types (numbers, booleans, objects, etc.)
+            if (logWarnings && 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 (logWarnings && 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
+ * @param options - Optional configuration for normalization behavior
+ * @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, options) {
+    const result = new Map();
+    for (const propName of propertyNames) {
+        const value = frontmatter[propName];
+        result.set(propName, normalizeProperty(value, propName, options));
+    }
+    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