@real1ty-obsidian-plugins/utils 2.30.0 → 2.32.0

package/dist/file/frontmatter-diff.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"frontmatter-diff.d.ts","sourceRoot":"","sources":["../../src/file/frontmatter-diff.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,WAAW,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAElD,MAAM,WAAW,iBAAiB;IACjC,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,EAAE,OAAO,CAAC;IAClB,QAAQ,EAAE,OAAO,CAAC;IAClB,UAAU,EAAE,OAAO,GAAG,UAAU,GAAG,SAAS,CAAC;CAC7C;AAED,MAAM,WAAW,eAAe;IAC/B,UAAU,EAAE,OAAO,CAAC;IACpB,OAAO,EAAE,iBAAiB,EAAE,CAAC;IAC7B,KAAK,EAAE,iBAAiB,EAAE,CAAC;IAC3B,QAAQ,EAAE,iBAAiB,EAAE,CAAC;IAC9B,OAAO,EAAE,iBAAiB,EAAE,CAAC;CAC7B;AAED;;;;;;;;GAQG;AACH,wBAAgB,kBAAkB,CACjC,cAAc,EAAE,WAAW,EAC3B,cAAc,EAAE,WAAW,EAC3B,YAAY,GAAE,GAAG,CAAC,MAAM,CAAa,GACnC,eAAe,CAwDjB;AAkCD;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,eAAe,EAAE,GAAG,eAAe,CA8C/E;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,iBAAiB,GAAG,MAAM,CAkBxE"}

package/dist/file/frontmatter-diff.js

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

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

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

package/dist/file/frontmatter-propagation.d.ts

@@ -0,0 +1,4 @@
+import type { App } from "obsidian";
+import type { Frontmatter, FrontmatterDiff } from "./frontmatter-diff";
+export declare function applyFrontmatterChanges(app: App, targetPath: string, sourceFrontmatter: Frontmatter, diff: FrontmatterDiff): Promise<void>;
+//# sourceMappingURL=frontmatter-propagation.d.ts.map

package/dist/file/frontmatter-propagation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"frontmatter-propagation.d.ts","sourceRoot":"","sources":["../../src/file/frontmatter-propagation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,UAAU,CAAC;AAEpC,OAAO,KAAK,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAEvE,wBAAsB,uBAAuB,CAC5C,GAAG,EAAE,GAAG,EACR,UAAU,EAAE,MAAM,EAClB,iBAAiB,EAAE,WAAW,EAC9B,IAAI,EAAE,eAAe,GACnB,OAAO,CAAC,IAAI,CAAC,CAwBf"}

package/dist/file/frontmatter-propagation.js

@@ -0,0 +1,28 @@
+import { __awaiter } from "tslib";
+import { TFile } from "obsidian";
+export function applyFrontmatterChanges(app, targetPath, sourceFrontmatter, diff) {
+    return __awaiter(this, void 0, void 0, function* () {
+        try {
+            const file = app.vault.getAbstractFileByPath(targetPath);
+            if (!(file instanceof TFile)) {
+                console.warn(`Target file not found: ${targetPath}`);
+                return;
+            }
+            yield app.fileManager.processFrontMatter(file, (fm) => {
+                for (const change of diff.added) {
+                    fm[change.key] = sourceFrontmatter[change.key];
+                }
+                for (const change of diff.modified) {
+                    fm[change.key] = sourceFrontmatter[change.key];
+                }
+                for (const change of diff.deleted) {
+                    delete fm[change.key];
+                }
+            });
+        }
+        catch (error) {
+            console.error(`Error applying frontmatter changes to ${targetPath}:`, error);
+        }
+    });
+}
+//# sourceMappingURL=frontmatter-propagation.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"frontmatter-propagation.js","sourceRoot":"","sources":["../../src/file/frontmatter-propagation.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,KAAK,EAAE,MAAM,UAAU,CAAC;AAGjC,MAAM,UAAgB,uBAAuB,CAC5C,GAAQ,EACR,UAAkB,EAClB,iBAA8B,EAC9B,IAAqB;;QAErB,IAAI,CAAC;YACJ,MAAM,IAAI,GAAG,GAAG,CAAC,KAAK,CAAC,qBAAqB,CAAC,UAAU,CAAC,CAAC;YACzD,IAAI,CAAC,CAAC,IAAI,YAAY,KAAK,CAAC,EAAE,CAAC;gBAC9B,OAAO,CAAC,IAAI,CAAC,0BAA0B,UAAU,EAAE,CAAC,CAAC;gBACrD,OAAO;YACR,CAAC;YAED,MAAM,GAAG,CAAC,WAAW,CAAC,kBAAkB,CAAC,IAAI,EAAE,CAAC,EAAE,EAAE,EAAE;gBACrD,KAAK,MAAM,MAAM,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;oBACjC,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,iBAAiB,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;gBAChD,CAAC;gBAED,KAAK,MAAM,MAAM,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;oBACpC,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,iBAAiB,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;gBAChD,CAAC;gBAED,KAAK,MAAM,MAAM,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;oBACnC,OAAO,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;gBACvB,CAAC;YACF,CAAC,CAAC,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YAChB,OAAO,CAAC,KAAK,CAAC,yCAAyC,UAAU,GAAG,EAAE,KAAK,CAAC,CAAC;QAC9E,CAAC;IACF,CAAC;CAAA","sourcesContent":["import type { App } from \"obsidian\";\nimport { TFile } from \"obsidian\";\nimport type { Frontmatter, FrontmatterDiff } from \"./frontmatter-diff\";\n\nexport async function applyFrontmatterChanges(\n\tapp: App,\n\ttargetPath: string,\n\tsourceFrontmatter: Frontmatter,\n\tdiff: FrontmatterDiff\n): Promise<void> {\n\ttry {\n\t\tconst file = app.vault.getAbstractFileByPath(targetPath);\n\t\tif (!(file instanceof TFile)) {\n\t\t\tconsole.warn(`Target file not found: ${targetPath}`);\n\t\t\treturn;\n\t\t}\n\n\t\tawait app.fileManager.processFrontMatter(file, (fm) => {\n\t\t\tfor (const change of diff.added) {\n\t\t\t\tfm[change.key] = sourceFrontmatter[change.key];\n\t\t\t}\n\n\t\t\tfor (const change of diff.modified) {\n\t\t\t\tfm[change.key] = sourceFrontmatter[change.key];\n\t\t\t}\n\n\t\t\tfor (const change of diff.deleted) {\n\t\t\t\tdelete fm[change.key];\n\t\t\t}\n\t\t});\n\t} catch (error) {\n\t\tconsole.error(`Error applying frontmatter changes to ${targetPath}:`, error);\n\t}\n}\n"]}

package/dist/file/frontmatter-serialization.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Creates file content with YAML frontmatter and body content.
+ * This is the atomic file creation format that prevents race conditions.
+ *
+ * @param frontmatter - Frontmatter as JSON object
+ * @param content - Body content (markdown text after frontmatter)
+ * @returns Complete file content with YAML frontmatter
+ */
+export declare function createFileContentWithFrontmatter(frontmatter: Record<string, unknown>, content?: string): string;
+/**
+ * Parses file content to extract frontmatter and body separately.
+ * Returns both the frontmatter object and the body content.
+ *
+ * @param fileContent - Complete file content including frontmatter
+ * @returns Object with frontmatter and body
+ */
+export declare function parseFileContent(fileContent: string): {
+    frontmatter: Record<string, unknown>;
+    body: string;
+};
+//# sourceMappingURL=frontmatter-serialization.d.ts.map

package/dist/file/frontmatter-serialization.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"frontmatter-serialization.d.ts","sourceRoot":"","sources":["../../src/file/frontmatter-serialization.ts"],"names":[],"mappings":"AAEA;;;;;;;GAOG;AACH,wBAAgB,gCAAgC,CAC/C,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACpC,OAAO,SAAK,GACV,MAAM,CAgCR;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,WAAW,EAAE,MAAM,GAAG;IACtD,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACrC,IAAI,EAAE,MAAM,CAAC;CACb,CAcA"}

package/dist/file/frontmatter-serialization.js

@@ -0,0 +1,57 @@
+import { stringify as stringifyYAML } from "yaml";
+/**
+ * Creates file content with YAML frontmatter and body content.
+ * This is the atomic file creation format that prevents race conditions.
+ *
+ * @param frontmatter - Frontmatter as JSON object
+ * @param content - Body content (markdown text after frontmatter)
+ * @returns Complete file content with YAML frontmatter
+ */
+export function createFileContentWithFrontmatter(frontmatter, content = "") {
+    if (!frontmatter || Object.keys(frontmatter).length === 0) {
+        // No frontmatter, just return content
+        return content;
+    }
+    // Use the yaml library to stringify frontmatter
+    // This handles all edge cases: special characters, multiline strings, arrays, nested objects, etc.
+    const yaml = stringifyYAML(frontmatter, {
+        // Use 2-space indentation (Obsidian standard)
+        indent: 2,
+        // Don't add document markers (--- at the end)
+        lineWidth: 0,
+        // Minimize unnecessary quotes
+        defaultStringType: "PLAIN",
+        // Handle null values explicitly
+        nullStr: "",
+    }).trim();
+    if (!yaml) {
+        // Empty frontmatter after stringification
+        return content;
+    }
+    // Ensure content doesn't start with extra newlines
+    const trimmedContent = content.replace(/^\n+/, "");
+    if (trimmedContent) {
+        return `---\n${yaml}\n---\n\n${trimmedContent}`;
+    }
+    return `---\n${yaml}\n---\n`;
+}
+/**
+ * Parses file content to extract frontmatter and body separately.
+ * Returns both the frontmatter object and the body content.
+ *
+ * @param fileContent - Complete file content including frontmatter
+ * @returns Object with frontmatter and body
+ */
+export function parseFileContent(fileContent) {
+    const frontmatterRegex = /^---\n([\s\S]*?)\n---\n?([\s\S]*)$/;
+    const match = fileContent.match(frontmatterRegex);
+    if (!match) {
+        // No frontmatter found
+        return { frontmatter: {}, body: fileContent };
+    }
+    const [, , body] = match;
+    // For this use case, we just need to split the file
+    // The frontmatter will be properly parsed when we read it back with Obsidian's APIs
+    return { frontmatter: {}, body: body.trim() };
+}
+//# sourceMappingURL=frontmatter-serialization.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"frontmatter-serialization.js","sourceRoot":"","sources":["../../src/file/frontmatter-serialization.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,IAAI,aAAa,EAAE,MAAM,MAAM,CAAC;AAElD;;;;;;;GAOG;AACH,MAAM,UAAU,gCAAgC,CAC/C,WAAoC,EACpC,OAAO,GAAG,EAAE;IAEZ,IAAI,CAAC,WAAW,IAAI,MAAM,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC3D,sCAAsC;QACtC,OAAO,OAAO,CAAC;IAChB,CAAC;IAED,gDAAgD;IAChD,mGAAmG;IACnG,MAAM,IAAI,GAAG,aAAa,CAAC,WAAW,EAAE;QACvC,8CAA8C;QAC9C,MAAM,EAAE,CAAC;QACT,8CAA8C;QAC9C,SAAS,EAAE,CAAC;QACZ,8BAA8B;QAC9B,iBAAiB,EAAE,OAAO;QAC1B,gCAAgC;QAChC,OAAO,EAAE,EAAE;KACX,CAAC,CAAC,IAAI,EAAE,CAAC;IAEV,IAAI,CAAC,IAAI,EAAE,CAAC;QACX,0CAA0C;QAC1C,OAAO,OAAO,CAAC;IAChB,CAAC;IAED,mDAAmD;IACnD,MAAM,cAAc,GAAG,OAAO,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;IAEnD,IAAI,cAAc,EAAE,CAAC;QACpB,OAAO,QAAQ,IAAI,YAAY,cAAc,EAAE,CAAC;IACjD,CAAC;IAED,OAAO,QAAQ,IAAI,SAAS,CAAC;AAC9B,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,gBAAgB,CAAC,WAAmB;IAInD,MAAM,gBAAgB,GAAG,oCAAoC,CAAC;IAC9D,MAAM,KAAK,GAAG,WAAW,CAAC,KAAK,CAAC,gBAAgB,CAAC,CAAC;IAElD,IAAI,CAAC,KAAK,EAAE,CAAC;QACZ,uBAAuB;QACvB,OAAO,EAAE,WAAW,EAAE,EAAE,EAAE,IAAI,EAAE,WAAW,EAAE,CAAC;IAC/C,CAAC;IAED,MAAM,CAAC,EAAE,AAAD,EAAG,IAAI,CAAC,GAAG,KAAK,CAAC;IAEzB,oDAAoD;IACpD,oFAAoF;IACpF,OAAO,EAAE,WAAW,EAAE,EAAE,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,EAAE,CAAC;AAC/C,CAAC","sourcesContent":["import { stringify as stringifyYAML } from \"yaml\";\n\n/**\n * Creates file content with YAML frontmatter and body content.\n * This is the atomic file creation format that prevents race conditions.\n *\n * @param frontmatter - Frontmatter as JSON object\n * @param content - Body content (markdown text after frontmatter)\n * @returns Complete file content with YAML frontmatter\n */\nexport function createFileContentWithFrontmatter(\n\tfrontmatter: Record<string, unknown>,\n\tcontent = \"\"\n): string {\n\tif (!frontmatter || Object.keys(frontmatter).length === 0) {\n\t\t// No frontmatter, just return content\n\t\treturn content;\n\t}\n\n\t// Use the yaml library to stringify frontmatter\n\t// This handles all edge cases: special characters, multiline strings, arrays, nested objects, etc.\n\tconst yaml = stringifyYAML(frontmatter, {\n\t\t// Use 2-space indentation (Obsidian standard)\n\t\tindent: 2,\n\t\t// Don't add document markers (--- at the end)\n\t\tlineWidth: 0,\n\t\t// Minimize unnecessary quotes\n\t\tdefaultStringType: \"PLAIN\",\n\t\t// Handle null values explicitly\n\t\tnullStr: \"\",\n\t}).trim();\n\n\tif (!yaml) {\n\t\t// Empty frontmatter after stringification\n\t\treturn content;\n\t}\n\n\t// Ensure content doesn't start with extra newlines\n\tconst trimmedContent = content.replace(/^\\n+/, \"\");\n\n\tif (trimmedContent) {\n\t\treturn `---\\n${yaml}\\n---\\n\\n${trimmedContent}`;\n\t}\n\n\treturn `---\\n${yaml}\\n---\\n`;\n}\n\n/**\n * Parses file content to extract frontmatter and body separately.\n * Returns both the frontmatter object and the body content.\n *\n * @param fileContent - Complete file content including frontmatter\n * @returns Object with frontmatter and body\n */\nexport function parseFileContent(fileContent: string): {\n\tfrontmatter: Record<string, unknown>;\n\tbody: string;\n} {\n\tconst frontmatterRegex = /^---\\n([\\s\\S]*?)\\n---\\n?([\\s\\S]*)$/;\n\tconst match = fileContent.match(frontmatterRegex);\n\n\tif (!match) {\n\t\t// No frontmatter found\n\t\treturn { frontmatter: {}, body: fileContent };\n\t}\n\n\tconst [, , body] = match;\n\n\t// For this use case, we just need to split the file\n\t// The frontmatter will be properly parsed when we read it back with Obsidian's APIs\n\treturn { frontmatter: {}, body: body.trim() };\n}\n"]}

package/dist/file/frontmatter.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Serializes a frontmatter value to a string representation for display in input fields.
+ * Converts arrays, objects, booleans, and numbers to their string representations.
+ */
+export declare function serializeFrontmatterValue(value: unknown): string;
+/**
+ * Parses a string value back to its original frontmatter type.
+ * Detects and converts to: arrays, objects, booleans, numbers, or keeps as string.
+ */
+export declare function parseFrontmatterValue(stringValue: string): unknown;
+/**
+ * Converts a record of string values back to their original frontmatter types.
+ */
+export declare function parseFrontmatterRecord(record: Record<string, string>): Record<string, unknown>;
+//# sourceMappingURL=frontmatter.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"frontmatter.d.ts","sourceRoot":"","sources":["../../src/file/frontmatter.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAkBhE;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAsClE;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAQ9F"}

package/dist/file/frontmatter.js

@@ -0,0 +1,68 @@
+/**
+ * Serializes a frontmatter value to a string representation for display in input fields.
+ * Converts arrays, objects, booleans, and numbers to their string representations.
+ */
+export function serializeFrontmatterValue(value) {
+    if (value === null || value === undefined) {
+        return "";
+    }
+    if (typeof value === "string") {
+        return value;
+    }
+    if (typeof value === "number" || typeof value === "boolean") {
+        return String(value);
+    }
+    if (Array.isArray(value) || typeof value === "object") {
+        return JSON.stringify(value);
+    }
+    return String(value);
+}
+/**
+ * Parses a string value back to its original frontmatter type.
+ * Detects and converts to: arrays, objects, booleans, numbers, or keeps as string.
+ */
+export function parseFrontmatterValue(stringValue) {
+    // Empty string
+    if (stringValue === "") {
+        return "";
+    }
+    // Try to parse as JSON (arrays, objects, null)
+    if ((stringValue.startsWith("[") && stringValue.endsWith("]")) ||
+        (stringValue.startsWith("{") && stringValue.endsWith("}")) ||
+        stringValue === "null") {
+        try {
+            return JSON.parse(stringValue);
+        }
+        catch (_a) {
+            // If JSON parse fails, return as string
+            return stringValue;
+        }
+    }
+    // Parse booleans
+    if (stringValue === "true") {
+        return true;
+    }
+    if (stringValue === "false") {
+        return false;
+    }
+    // Parse numbers (including integers and floats)
+    if (/^-?\d+(\.\d+)?$/.test(stringValue)) {
+        const num = Number(stringValue);
+        if (!Number.isNaN(num)) {
+            return num;
+        }
+    }
+    // Return as string if no other type matches
+    return stringValue;
+}
+/**
+ * Converts a record of string values back to their original frontmatter types.
+ */
+export function parseFrontmatterRecord(record) {
+    const parsed = {};
+    for (const [key, value] of Object.entries(record)) {
+        parsed[key] = parseFrontmatterValue(value);
+    }
+    return parsed;
+}
+//# sourceMappingURL=frontmatter.js.map

package/dist/file/frontmatter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"frontmatter.js","sourceRoot":"","sources":["../../src/file/frontmatter.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,UAAU,yBAAyB,CAAC,KAAc;IACvD,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;QAC3C,OAAO,EAAE,CAAC;IACX,CAAC;IAED,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC/B,OAAO,KAAK,CAAC;IACd,CAAC;IAED,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,OAAO,KAAK,KAAK,SAAS,EAAE,CAAC;QAC7D,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC;IACtB,CAAC;IAED,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QACvD,OAAO,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;IAC9B,CAAC;IAED,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC;AACtB,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,qBAAqB,CAAC,WAAmB;IACxD,eAAe;IACf,IAAI,WAAW,KAAK,EAAE,EAAE,CAAC;QACxB,OAAO,EAAE,CAAC;IACX,CAAC;IAED,+CAA+C;IAC/C,IACC,CAAC,WAAW,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,WAAW,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;QAC1D,CAAC,WAAW,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,WAAW,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;QAC1D,WAAW,KAAK,MAAM,EACrB,CAAC;QACF,IAAI,CAAC;YACJ,OAAO,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC;QAChC,CAAC;QAAC,WAAM,CAAC;YACR,wCAAwC;YACxC,OAAO,WAAW,CAAC;QACpB,CAAC;IACF,CAAC;IAED,iBAAiB;IACjB,IAAI,WAAW,KAAK,MAAM,EAAE,CAAC;QAC5B,OAAO,IAAI,CAAC;IACb,CAAC;IACD,IAAI,WAAW,KAAK,OAAO,EAAE,CAAC;QAC7B,OAAO,KAAK,CAAC;IACd,CAAC;IAED,gDAAgD;IAChD,IAAI,iBAAiB,CAAC,IAAI,CAAC,WAAW,CAAC,EAAE,CAAC;QACzC,MAAM,GAAG,GAAG,MAAM,CAAC,WAAW,CAAC,CAAC;QAChC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC;YACxB,OAAO,GAAG,CAAC;QACZ,CAAC;IACF,CAAC;IAED,4CAA4C;IAC5C,OAAO,WAAW,CAAC;AACpB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,sBAAsB,CAAC,MAA8B;IACpE,MAAM,MAAM,GAA4B,EAAE,CAAC;IAE3C,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;QACnD,MAAM,CAAC,GAAG,CAAC,GAAG,qBAAqB,CAAC,KAAK,CAAC,CAAC;IAC5C,CAAC;IAED,OAAO,MAAM,CAAC;AACf,CAAC","sourcesContent":["/**\n * Serializes a frontmatter value to a string representation for display in input fields.\n * Converts arrays, objects, booleans, and numbers to their string representations.\n */\nexport function serializeFrontmatterValue(value: unknown): string {\n\tif (value === null || value === undefined) {\n\t\treturn \"\";\n\t}\n\n\tif (typeof value === \"string\") {\n\t\treturn value;\n\t}\n\n\tif (typeof value === \"number\" || typeof value === \"boolean\") {\n\t\treturn String(value);\n\t}\n\n\tif (Array.isArray(value) || typeof value === \"object\") {\n\t\treturn JSON.stringify(value);\n\t}\n\n\treturn String(value);\n}\n\n/**\n * Parses a string value back to its original frontmatter type.\n * Detects and converts to: arrays, objects, booleans, numbers, or keeps as string.\n */\nexport function parseFrontmatterValue(stringValue: string): unknown {\n\t// Empty string\n\tif (stringValue === \"\") {\n\t\treturn \"\";\n\t}\n\n\t// Try to parse as JSON (arrays, objects, null)\n\tif (\n\t\t(stringValue.startsWith(\"[\") && stringValue.endsWith(\"]\")) ||\n\t\t(stringValue.startsWith(\"{\") && stringValue.endsWith(\"}\")) ||\n\t\tstringValue === \"null\"\n\t) {\n\t\ttry {\n\t\t\treturn JSON.parse(stringValue);\n\t\t} catch {\n\t\t\t// If JSON parse fails, return as string\n\t\t\treturn stringValue;\n\t\t}\n\t}\n\n\t// Parse booleans\n\tif (stringValue === \"true\") {\n\t\treturn true;\n\t}\n\tif (stringValue === \"false\") {\n\t\treturn false;\n\t}\n\n\t// Parse numbers (including integers and floats)\n\tif (/^-?\\d+(\\.\\d+)?$/.test(stringValue)) {\n\t\tconst num = Number(stringValue);\n\t\tif (!Number.isNaN(num)) {\n\t\t\treturn num;\n\t\t}\n\t}\n\n\t// Return as string if no other type matches\n\treturn stringValue;\n}\n\n/**\n * Converts a record of string values back to their original frontmatter types.\n */\nexport function parseFrontmatterRecord(record: Record<string, string>): Record<string, unknown> {\n\tconst parsed: Record<string, unknown> = {};\n\n\tfor (const [key, value] of Object.entries(record)) {\n\t\tparsed[key] = parseFrontmatterValue(value);\n\t}\n\n\treturn parsed;\n}\n"]}

package/dist/file/index.d.ts

@@ -0,0 +1,13 @@
+export * from "./child-reference";
+export * from "./file";
+export * from "./file-operations";
+export * from "./file-utils";
+export * from "./frontmatter";
+export * from "./frontmatter-diff";
+export * from "./frontmatter-propagation";
+export * from "./frontmatter-serialization";
+export * from "./link-parser";
+export * from "./property-utils";
+export * from "./templater";
+export * from "./templater-service";
+//# sourceMappingURL=index.d.ts.map

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

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

package/dist/file/index.js

@@ -0,0 +1,13 @@
+export * from "./child-reference";
+export * from "./file";
+export * from "./file-operations";
+export * from "./file-utils";
+export * from "./frontmatter";
+export * from "./frontmatter-diff";
+export * from "./frontmatter-propagation";
+export * from "./frontmatter-serialization";
+export * from "./link-parser";
+export * from "./property-utils";
+export * from "./templater";
+export * from "./templater-service";
+//# sourceMappingURL=index.js.map

package/dist/file/index.js.map

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

package/dist/file/link-parser.d.ts

@@ -0,0 +1,63 @@
+/**
+ * Handles different link formats and edge cases:
+ * [[FileName]] -> FileName.md
+ * [[Folder/FileName]] -> Folder/FileName.md
+ * [[Folder/FileName|DisplayName]] -> Folder/FileName.md
+ * Normalizes paths and handles malformed links gracefully.
+ */
+export declare const extractFilePathFromLink: (link: string) => string | null;
+/**
+ * Parses an Obsidian wiki link to extract the file path.
+ * Handles formats like:
+ * - [[path/to/file]]
+ * - [[path/to/file|Display Name]]
+ *
+ * @param link - The wiki link string
+ * @returns The file path without the [[ ]] brackets, or null if invalid
+ */
+export declare function parseWikiLink(link: string): string | null;
+/**
+ * Parses a property value that can be a single link or an array of links.
+ * Extracts file paths from all valid wiki links.
+ *
+ * @param value - The property value (string, string[], or undefined)
+ * @returns Array of file paths, empty if no valid links found
+ */
+export declare function parsePropertyLinks(value: string | string[] | undefined): string[];
+/**
+ * Formats a file path as an Obsidian wiki link with display name.
+ * Example: "Projects/MyProject" -> "[[Projects/MyProject|MyProject]]"
+ *
+ * @param filePath - The file path to format
+ * @returns The formatted wiki link with display name alias
+ */
+export declare function formatWikiLink(filePath: string): string;
+/**
+ * Represents a parsed Obsidian link with its components
+ */
+export interface ObsidianLink {
+    raw: string;
+    path: string;
+    alias: string;
+}
+/**
+ * Checks if a value is an Obsidian internal link in the format [[...]]
+ */
+export declare function isObsidianLink(value: unknown): boolean;
+/**
+ * Parses an Obsidian internal link and extracts its components
+ *
+ * Supports both formats:
+ * - Simple: [[Page Name]]
+ * - With alias: [[Path/To/Page|Display Name]]
+ */
+export declare function parseObsidianLink(linkString: string): ObsidianLink | null;
+/**
+ * Gets the display alias from an Obsidian link
+ */
+export declare function getObsidianLinkAlias(linkString: string): string;
+/**
+ * Gets the file path from an Obsidian link
+ */
+export declare function getObsidianLinkPath(linkString: string): string;
+//# sourceMappingURL=link-parser.d.ts.map

package/dist/file/link-parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"link-parser.d.ts","sourceRoot":"","sources":["../../src/file/link-parser.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,eAAO,MAAM,uBAAuB,GAAI,MAAM,MAAM,KAAG,MAAM,GAAG,IAU/D,CAAC;AAEF;;;;;;;;GAQG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAezD;AAED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,SAAS,GAAG,MAAM,EAAE,CAQjF;AAED;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAqBvD;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC5B,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;CACd;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAItD;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,UAAU,EAAE,MAAM,GAAG,YAAY,GAAG,IAAI,CA4BzE;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAG/D;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAG9D"}