@real1ty-obsidian-plugins/utils 2.29.0 → 2.30.0

package/dist/file/file.js

@@ -1,559 +0,0 @@
-import { __awaiter } from "tslib";
-import { normalizePath, TFile } from "obsidian";
-// ============================================================================
-// File Path Operations
-// ============================================================================
-/**
- * Retrieves a TFile object from the vault by its path.
- * Handles path normalization using Obsidian's normalizePath utility.
- *
- * **Important**: Obsidian file paths ALWAYS include the `.md` extension.
- * The TFile.path property returns paths like "folder/file.md", not "folder/file".
- *
- * @param app - The Obsidian App instance
- * @param filePath - Path to the file (will be normalized, should include .md extension)
- * @returns TFile if found, null otherwise
- *
- * @example
- * ```ts
- * // Correct: Include .md extension
- * const file = getFileByPath(app, "folder/note.md");
- *
- * // For wikilinks without extension, add .md
- * const linkPath = "MyNote";
- * const file = getFileByPath(app, `${linkPath}.md`);
- * ```
- */
-export function getFileByPath(app, filePath) {
-    // Normalize the path using Obsidian's utility
-    // This handles slashes, spaces, and platform-specific path issues
-    const normalizedPath = normalizePath(filePath);
-    // Use Vault's direct lookup method (most efficient)
-    // Prefer getFileByPath if available, otherwise use getAbstractFileByPath
-    if (typeof app.vault.getFileByPath === "function") {
-        return app.vault.getFileByPath(normalizedPath);
-    }
-    const abstractFile = app.vault.getAbstractFileByPath(normalizedPath);
-    return abstractFile instanceof TFile ? abstractFile : null;
-}
-/**
- * Ensures a file path includes the .md extension.
- * Use this when working with wikilinks or user input that may omit extensions.
- *
- * @param path - File path that may or may not include .md extension
- * @returns Path guaranteed to end with .md
- *
- * @example
- * ```ts
- * ensureMarkdownExtension("MyNote") // "MyNote.md"
- * ensureMarkdownExtension("MyNote.md") // "MyNote.md"
- * ensureMarkdownExtension("folder/note") // "folder/note.md"
- * ```
- */
-export function ensureMarkdownExtension(path) {
-    return path.endsWith(".md") ? path : `${path}.md`;
-}
-/**
- * Removes the .md extension from a file path if present.
- * Useful for displaying file names or creating wikilinks.
- *
- * @param path - File path that may include .md extension
- * @returns Path without .md extension
- *
- * @example
- * ```ts
- * removeMarkdownExtension("folder/note.md") // "folder/note"
- * removeMarkdownExtension("folder/note") // "folder/note"
- * ```
- */
-export function removeMarkdownExtension(path) {
-    return path.endsWith(".md") ? path.slice(0, -3) : path;
-}
-// ============================================================================
-// File Name Extraction
-// ============================================================================
-/**
- * Extracts the display name from a file path or wiki link.
- *
- * Handles various formats:
- * - `[[path/to/file|Alias]]` -> returns "Alias"
- * - `[[path/to/file]]` -> returns "file"
- * - `path/to/file.md` -> returns "file"
- * - `file.md` -> returns "file"
- *
- * @param input - File path or wiki link string
- * @returns The display name to show in the UI
- */
-export function extractDisplayName(input) {
-    if (!input)
-        return "";
-    // Remove any surrounding whitespace
-    const trimmed = input.trim();
-    // Check if it's a wiki link format [[path|alias]] or [[path]]
-    const wikiLinkMatch = trimmed.match(/^\[\[([^\]]+)\]\]$/);
-    if (wikiLinkMatch) {
-        const innerContent = wikiLinkMatch[1];
-        // Check if there's an alias (pipe character)
-        const pipeIndex = innerContent.indexOf("|");
-        if (pipeIndex !== -1) {
-            // Return the alias (everything after the pipe)
-            return innerContent.substring(pipeIndex + 1).trim();
-        }
-        // No alias, extract filename from path
-        const path = innerContent.trim();
-        const lastSlashIndex = path.lastIndexOf("/");
-        const filename = lastSlashIndex !== -1 ? path.substring(lastSlashIndex + 1) : path;
-        return filename.replace(/\.md$/i, "");
-    }
-    // Not a wiki link, treat as regular path
-    const lastSlashIndex = trimmed.lastIndexOf("/");
-    const filename = lastSlashIndex !== -1 ? trimmed.substring(lastSlashIndex + 1) : trimmed;
-    return filename.replace(/\.md$/i, "");
-}
-/**
- * Extracts the actual file path from a wiki link or returns the path as-is.
- *
- * Handles:
- * - `[[path/to/file|Alias]]` -> returns "path/to/file.md"
- * - `[[path/to/file]]` -> returns "path/to/file.md"
- * - `path/to/file.md` -> returns "path/to/file.md"
- *
- * @param input - File path or wiki link string
- * @returns The actual file path (with .md extension)
- */
-export function extractFilePath(input) {
-    if (!input)
-        return "";
-    const trimmed = input.trim();
-    // Check if it's a wiki link format [[path|alias]] or [[path]]
-    const wikiLinkMatch = trimmed.match(/^\[\[([^\]]+)\]\]$/);
-    if (wikiLinkMatch) {
-        const innerContent = wikiLinkMatch[1];
-        // Check if there's an alias (pipe character)
-        const pipeIndex = innerContent.indexOf("|");
-        const path = pipeIndex !== -1 ? innerContent.substring(0, pipeIndex).trim() : innerContent.trim();
-        // Ensure .md extension
-        return path.endsWith(".md") ? path : `${path}.md`;
-    }
-    // Not a wiki link, ensure .md extension
-    return trimmed.endsWith(".md") ? trimmed : `${trimmed}.md`;
-}
-/**
- * Creates a comprehensive file context object containing all relevant file information.
- * Handles path normalization, file lookup, and metadata caching.
- */
-export function getFileContext(app, path) {
-    const pathWithExt = ensureMarkdownExtension(path);
-    const baseName = removeMarkdownExtension(path);
-    const file = getFileByPath(app, pathWithExt);
-    const cache = file ? app.metadataCache.getFileCache(file) : null;
-    const frontmatter = cache === null || cache === void 0 ? void 0 : cache.frontmatter;
-    return {
-        path,
-        pathWithExt,
-        baseName,
-        file,
-        frontmatter,
-        cache,
-    };
-}
-/**
- * Helper function to work with file context that automatically handles file not found cases.
- * Returns null if the file doesn't exist, otherwise executes the callback with the context.
- */
-export function withFileContext(app, path, callback) {
-    return __awaiter(this, void 0, void 0, function* () {
-        const context = getFileContext(app, path);
-        if (!context.file) {
-            console.warn(`File not found: ${context.pathWithExt}`);
-            return null;
-        }
-        return yield callback(context);
-    });
-}
-// ============================================================================
-// File Path Generation
-// ============================================================================
-/**
- * Generates a unique file path by appending a counter if the file already exists.
- * Automatically adds .md extension if not present.
- *
- * @param app - The Obsidian App instance
- * @param folder - Folder path (empty string for root, no trailing slash needed)
- * @param baseName - Base file name without extension
- * @returns Unique file path that doesn't exist in the vault
- *
- * @example
- * ```ts
- * // If "MyNote.md" exists, returns "MyNote 1.md"
- * const path = getUniqueFilePath(app, "", "MyNote");
- *
- * // With folder: "Projects/Task.md" -> "Projects/Task 1.md"
- * const path = getUniqueFilePath(app, "Projects", "Task");
- *
- * // Root folder handling
- * const path = getUniqueFilePath(app, "/", "Note"); // -> "Note.md"
- * ```
- */
-export function getUniqueFilePath(app, folder, baseName) {
-    const normalizedFolder = folder && folder !== "/" ? folder : "";
-    const folderPath = normalizedFolder ? `${normalizedFolder}/` : "";
-    let fileName = `${baseName}.md`;
-    let fullPath = `${folderPath}${fileName}`;
-    let counter = 1;
-    while (app.vault.getAbstractFileByPath(fullPath)) {
-        fileName = `${baseName} ${counter}.md`;
-        fullPath = `${folderPath}${fileName}`;
-        counter++;
-    }
-    return fullPath;
-}
-/**
- * Generates a unique file path by appending a counter if the file already exists.
- * Accepts a complete file path and iterates with a counter suffix.
- *
- * @param app - The Obsidian App instance
- * @param filePath - Complete file path including folder, name, and extension
- * @returns Unique file path that doesn't exist in the vault
- *
- * @example
- * ```ts
- * // If "folder/note.md" exists, returns "folder/note 1.md"
- * const path = getUniqueFilePathFromFull(app, "folder/note.md");
- *
- * // Works with any extension
- * const path = getUniqueFilePathFromFull(app, "assets/image.png");
- * // -> "assets/image 1.png" if image.png exists
- * ```
- */
-export const getUniqueFilePathFromFull = (app, filePath) => {
-    // If file doesn't exist, return as-is
-    if (!app.vault.getAbstractFileByPath(filePath)) {
-        return filePath;
-    }
-    // Extract folder, base name, and extension
-    const lastSlashIndex = filePath.lastIndexOf("/");
-    const folderPath = lastSlashIndex !== -1 ? filePath.substring(0, lastSlashIndex + 1) : "";
-    const fileName = lastSlashIndex !== -1 ? filePath.substring(lastSlashIndex + 1) : filePath;
-    const lastDotIndex = fileName.lastIndexOf(".");
-    const baseName = lastDotIndex !== -1 ? fileName.substring(0, lastDotIndex) : fileName;
-    const extension = lastDotIndex !== -1 ? fileName.substring(lastDotIndex) : "";
-    let counter = 1;
-    let uniquePath = `${folderPath}${baseName} ${counter}${extension}`;
-    while (app.vault.getAbstractFileByPath(uniquePath)) {
-        counter++;
-        uniquePath = `${folderPath}${baseName} ${counter}${extension}`;
-    }
-    return uniquePath;
-};
-/**
- * Generates a unique file path by appending a counter if the file already exists.
- * Supports custom file extensions.
- *
- * @param app - The Obsidian App instance
- * @param folder - Folder path (empty string for root)
- * @param baseName - Base file name without extension
- * @param extension - File extension (defaults to "md")
- * @returns Unique file path that doesn't exist in the vault
- */
-export const generateUniqueFilePath = (app, folder, baseName, extension = "md") => {
-    const folderPath = folder ? `${folder}/` : "";
-    const fullPath = `${folderPath}${baseName}.${extension}`;
-    return getUniqueFilePathFromFull(app, fullPath);
-};
-// ============================================================================
-// Folder Note Operations
-// ============================================================================
-/**
- * Checks if a file is a folder note.
- * A folder note is a file whose name matches its parent folder name.
- *
- * @param filePath - Path to the file (e.g., "tasks/tasks.md")
- * @returns true if the file is a folder note, false otherwise
- *
- * @example
- * ```ts
- * isFolderNote("tasks/tasks.md") // true
- * isFolderNote("tasks/subtask.md") // false
- * isFolderNote("note.md") // false (no parent folder)
- * isFolderNote("projects/docs/docs.md") // true
- * ```
- */
-export function isFolderNote(filePath) {
-    if (!filePath)
-        return false;
-    // Remove .md extension for comparison
-    const pathWithoutExt = removeMarkdownExtension(filePath);
-    // Split path into segments
-    const segments = pathWithoutExt.split("/");
-    // Need at least 2 segments (folder/file)
-    if (segments.length < 2)
-        return false;
-    // Get the file name (last segment) and parent folder name (second to last)
-    const fileName = segments[segments.length - 1];
-    const parentFolderName = segments[segments.length - 2];
-    // File is a folder note if its name matches the parent folder
-    return fileName === parentFolderName;
-}
-/**
- * Gets the folder path for a file.
- *
- * @param filePath - Path to the file (e.g., "tasks/subtask.md")
- * @returns Folder path without trailing slash, or empty string if file is in root
- *
- * @example
- * ```ts
- * getFolderPath("tasks/subtask.md") // "tasks"
- * getFolderPath("projects/docs/notes.md") // "projects/docs"
- * getFolderPath("note.md") // ""
- * ```
- */
-export function getFolderPath(filePath) {
-    if (!filePath)
-        return "";
-    const lastSlashIndex = filePath.lastIndexOf("/");
-    if (lastSlashIndex === -1)
-        return "";
-    return filePath.substring(0, lastSlashIndex);
-}
-/**
- * Gets all markdown files in a specific folder (non-recursive).
- *
- * @param app - The Obsidian App instance
- * @param folderPath - Path to the folder (e.g., "tasks")
- * @returns Array of TFile objects in the folder
- *
- * @example
- * ```ts
- * const files = getFilesInFolder(app, "tasks");
- * // Returns [task1.md, task2.md, tasks.md] but not tasks/subtasks/file.md
- * ```
- */
-export function getFilesInFolder(app, folderPath) {
-    const allFiles = app.vault.getMarkdownFiles();
-    return allFiles.filter((file) => {
-        const fileFolder = getFolderPath(file.path);
-        return fileFolder === folderPath;
-    });
-}
-/**
- * Gets all markdown files in a folder and its subfolders recursively.
- *
- * @param app - The Obsidian App instance
- * @param folderPath - Path to the folder (e.g., "tasks")
- * @returns Array of TFile objects in the folder tree
- *
- * @example
- * ```ts
- * const files = getAllFilesInFolderTree(app, "tasks");
- * // Returns all .md files in tasks/ and all its subdirectories
- * ```
- */
-export function getAllFilesInFolderTree(app, folderPath) {
-    const allFiles = app.vault.getMarkdownFiles();
-    const normalizedFolder = folderPath ? `${folderPath}/` : "";
-    return allFiles.filter((file) => {
-        if (!normalizedFolder)
-            return true; // Root folder includes all files
-        return file.path.startsWith(normalizedFolder);
-    });
-}
-/**
- * Gets the parent file path based on folder structure.
- * For a file in a folder, the parent is the folder note if it exists.
- *
- * @param app - The Obsidian App instance
- * @param filePath - Path to the file
- * @returns Path to parent file, or null if no parent exists
- *
- * @example
- * ```ts
- * // If tasks/tasks.md exists
- * getParentByFolder(app, "tasks/subtask.md") // "tasks/tasks.md"
- *
- * // If parent folder note doesn't exist
- * getParentByFolder(app, "tasks/subtask.md") // null
- *
- * // Root level file
- * getParentByFolder(app, "note.md") // null
- * ```
- */
-export function getParentByFolder(app, filePath) {
-    const folderPath = getFolderPath(filePath);
-    if (!folderPath)
-        return null; // File is at root level
-    // Check if folder note exists
-    const folderSegments = folderPath.split("/");
-    const parentFolderName = folderSegments[folderSegments.length - 1];
-    const potentialParentPath = `${folderPath}/${parentFolderName}.md`;
-    const parentFile = getFileByPath(app, potentialParentPath);
-    return parentFile ? potentialParentPath : null;
-}
-/**
- * Gets all child file paths based on folder structure.
- * Works for both folder notes and regular files.
- *
- * For folder notes (e.g., "tasks/tasks.md"):
- * - Returns all files directly in the folder (excluding the folder note)
- * - Includes subfolder notes one level down
- *
- * For regular files (e.g., "tasks/task1.md"):
- * - Returns the folder note from matching subfolder if it exists (e.g., "tasks/task1/task1.md")
- *
- * @param app - The Obsidian App instance
- * @param filePath - Path to the file
- * @returns Array of child file paths
- *
- * @example
- * ```ts
- * // For tasks/tasks.md (folder note)
- * getChildrenByFolder(app, "tasks/tasks.md")
- * // Returns ["tasks/task1.md", "tasks/task2.md", "tasks/subtasks/subtasks.md"]
- *
- * // For tasks/task1.md (regular file with matching subfolder)
- * getChildrenByFolder(app, "tasks/task1.md")
- * // Returns ["tasks/task1/task1.md"] if it exists
- * ```
- */
-export function getChildrenByFolder(app, filePath) {
-    const allFiles = app.vault.getMarkdownFiles();
-    // Case 1: Folder note - get all files in the folder
-    if (isFolderNote(filePath)) {
-        const folderPath = getFolderPath(filePath);
-        const children = [];
-        allFiles.forEach((file) => {
-            // Skip the folder note itself
-            if (file.path === filePath)
-                return;
-            const fileFolder = getFolderPath(file.path);
-            // Direct child: file is in the same folder as the folder note
-            if (fileFolder === folderPath) {
-                children.push(file.path);
-                return;
-            }
-            // Subfolder note: file is a folder note one level deeper
-            // e.g., for "tasks/tasks.md", include "tasks/subtasks/subtasks.md"
-            if (fileFolder.startsWith(`${folderPath}/`)) {
-                // Check if it's exactly one level deeper and is a folder note
-                const relativePath = fileFolder.substring(folderPath.length + 1);
-                const isOneLevel = !relativePath.includes("/");
-                if (isOneLevel && isFolderNote(file.path)) {
-                    children.push(file.path);
-                }
-            }
-        });
-        return children;
-    }
-    // Case 2: Regular file - check for matching subfolder with folder note
-    const pathWithoutExt = removeMarkdownExtension(filePath);
-    const fileName = pathWithoutExt.split("/").pop() || "";
-    const potentialChildFolder = `${pathWithoutExt}`;
-    const potentialChildPath = `${potentialChildFolder}/${fileName}.md`;
-    // Check if the child folder note exists
-    const childFile = getFileByPath(app, potentialChildPath);
-    return childFile ? [potentialChildPath] : [];
-}
-/**
- * Finds all root nodes in a folder tree.
- * Root nodes are files at the top level of the folder (directly in the folder, not in subfolders).
- *
- * @param app - The Obsidian App instance
- * @param folderPath - Path to the folder
- * @returns Array of root file paths
- *
- * @example
- * ```ts
- * // For folder structure:
- * // tasks/
- * //   tasks.md (folder note)
- * //   task1.md
- * //   subtasks/
- * //     subtasks.md
- * //     subtask1.md
- *
- * findRootNodesInFolder(app, "tasks")
- * // Returns ["tasks/tasks.md", "tasks/task1.md"]
- * // Excludes subtasks/subtasks.md and subtasks/subtask1.md (they're in subfolder)
- * ```
- */
-export function findRootNodesInFolder(app, folderPath) {
-    return getFilesInFolder(app, folderPath).map((file) => file.path);
-}
-/**
- * Sanitizes a string for use as a filename.
- * Defaults to kebab-case style for backwards compatibility.
- *
- * @param input - String to sanitize
- * @param options - Sanitization options
- * @returns Sanitized filename string
- *
- * @example
- * // Default kebab-case style (backwards compatible)
- * sanitizeForFilename("My File Name") // "my-file-name"
- *
- * // Preserve spaces and case
- * sanitizeForFilename("My File Name", { style: "preserve" }) // "My File Name"
- */
-export const sanitizeForFilename = (input, options = {}) => {
-    const { style = "kebab" } = options;
-    if (style === "preserve") {
-        return sanitizeFilenamePreserveSpaces(input);
-    }
-    // Default: kebab-case style (legacy behavior)
-    return sanitizeFilenameKebabCase(input);
-};
-/**
- * Sanitizes filename using kebab-case style.
- * - Removes invalid characters
- * - Converts to lowercase
- * - Replaces spaces with hyphens
- *
- * Best for: CLI tools, URLs, slugs, technical files
- *
- * @example
- * sanitizeFilenameKebabCase("My File Name") // "my-file-name"
- * sanitizeFilenameKebabCase("Travel Around The World") // "travel-around-the-world"
- */
-export const sanitizeFilenameKebabCase = (input) => {
-    return (input
-        // Remove invalid filename characters
-        .replace(/[<>:"/\\|?*]/g, "")
-        // Replace spaces with hyphens
-        .replace(/\s+/g, "-")
-        // Replace multiple hyphens with single
-        .replace(/-+/g, "-")
-        // Remove leading/trailing hyphens
-        .replace(/^-|-$/g, "")
-        // Convert to lowercase
-        .toLowerCase());
-};
-/**
- * Sanitizes filename while preserving spaces and case.
- * - Removes invalid characters only
- * - Preserves spaces and original casing
- * - Removes trailing dots (Windows compatibility)
- *
- * Best for: Note titles, human-readable filenames, Obsidian notes
- *
- * @example
- * sanitizeFilenamePreserveSpaces("My File Name") // "My File Name"
- * sanitizeFilenamePreserveSpaces("Travel Around The World") // "Travel Around The World"
- * sanitizeFilenamePreserveSpaces("File<Invalid>Chars") // "FileInvalidChars"
- */
-export const sanitizeFilenamePreserveSpaces = (input) => {
-    return (input
-        // Remove invalid filename characters (cross-platform compatibility)
-        .replace(/[<>:"/\\|?*]/g, "")
-        // Remove trailing dots (invalid on Windows)
-        .replace(/\.+$/g, "")
-        // Remove leading/trailing whitespace
-        .trim());
-};
-export const getFilenameFromPath = (filePath) => {
-    return filePath.split("/").pop() || "Unknown";
-};
-export const isFileInConfiguredDirectory = (filePath, directory) => {
-    const normalizedDir = directory.endsWith("/") ? directory.slice(0, -1) : directory;
-    return filePath.startsWith(`${normalizedDir}/`) || filePath === normalizedDir;
-};
-//# sourceMappingURL=file.js.map

package/dist/file/file.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"file.js","sourceRoot":"","sources":["../../src/file/file.ts"],"names":[],"mappings":"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","sourcesContent":["import type { App, CachedMetadata } from \"obsidian\";\nimport { normalizePath, TFile } from \"obsidian\";\n\n// ============================================================================\n// File Path Operations\n// ============================================================================\n\n/**\n * Retrieves a TFile object from the vault by its path.\n * Handles path normalization using Obsidian's normalizePath utility.\n *\n * **Important**: Obsidian file paths ALWAYS include the `.md` extension.\n * The TFile.path property returns paths like \"folder/file.md\", not \"folder/file\".\n *\n * @param app - The Obsidian App instance\n * @param filePath - Path to the file (will be normalized, should include .md extension)\n * @returns TFile if found, null otherwise\n *\n * @example\n * ```ts\n * // Correct: Include .md extension\n * const file = getFileByPath(app, \"folder/note.md\");\n *\n * // For wikilinks without extension, add .md\n * const linkPath = \"MyNote\";\n * const file = getFileByPath(app, `${linkPath}.md`);\n * ```\n */\nexport function getFileByPath(app: App, filePath: string): TFile | null {\n\t// Normalize the path using Obsidian's utility\n\t// This handles slashes, spaces, and platform-specific path issues\n\tconst normalizedPath = normalizePath(filePath);\n\n\t// Use Vault's direct lookup method (most efficient)\n\t// Prefer getFileByPath if available, otherwise use getAbstractFileByPath\n\tif (typeof app.vault.getFileByPath === \"function\") {\n\t\treturn app.vault.getFileByPath(normalizedPath);\n\t}\n\n\tconst abstractFile = app.vault.getAbstractFileByPath(normalizedPath);\n\n\treturn abstractFile instanceof TFile ? abstractFile : null;\n}\n\n/**\n * Ensures a file path includes the .md extension.\n * Use this when working with wikilinks or user input that may omit extensions.\n *\n * @param path - File path that may or may not include .md extension\n * @returns Path guaranteed to end with .md\n *\n * @example\n * ```ts\n * ensureMarkdownExtension(\"MyNote\") // \"MyNote.md\"\n * ensureMarkdownExtension(\"MyNote.md\") // \"MyNote.md\"\n * ensureMarkdownExtension(\"folder/note\") // \"folder/note.md\"\n * ```\n */\nexport function ensureMarkdownExtension(path: string): string {\n\treturn path.endsWith(\".md\") ? path : `${path}.md`;\n}\n\n/**\n * Removes the .md extension from a file path if present.\n * Useful for displaying file names or creating wikilinks.\n *\n * @param path - File path that may include .md extension\n * @returns Path without .md extension\n *\n * @example\n * ```ts\n * removeMarkdownExtension(\"folder/note.md\") // \"folder/note\"\n * removeMarkdownExtension(\"folder/note\") // \"folder/note\"\n * ```\n */\nexport function removeMarkdownExtension(path: string): string {\n\treturn path.endsWith(\".md\") ? path.slice(0, -3) : path;\n}\n\n// ============================================================================\n// File Name Extraction\n// ============================================================================\n\n/**\n * Extracts the display name from a file path or wiki link.\n *\n * Handles various formats:\n * - `[[path/to/file|Alias]]` -> returns \"Alias\"\n * - `[[path/to/file]]` -> returns \"file\"\n * - `path/to/file.md` -> returns \"file\"\n * - `file.md` -> returns \"file\"\n *\n * @param input - File path or wiki link string\n * @returns The display name to show in the UI\n */\nexport function extractDisplayName(input: string): string {\n\tif (!input) return \"\";\n\n\t// Remove any surrounding whitespace\n\tconst trimmed = input.trim();\n\n\t// Check if it's a wiki link format [[path|alias]] or [[path]]\n\tconst wikiLinkMatch = trimmed.match(/^\\[\\[([^\\]]+)\\]\\]$/);\n\n\tif (wikiLinkMatch) {\n\t\tconst innerContent = wikiLinkMatch[1];\n\n\t\t// Check if there's an alias (pipe character)\n\t\tconst pipeIndex = innerContent.indexOf(\"|\");\n\n\t\tif (pipeIndex !== -1) {\n\t\t\t// Return the alias (everything after the pipe)\n\t\t\treturn innerContent.substring(pipeIndex + 1).trim();\n\t\t}\n\n\t\t// No alias, extract filename from path\n\t\tconst path = innerContent.trim();\n\n\t\tconst lastSlashIndex = path.lastIndexOf(\"/\");\n\n\t\tconst filename = lastSlashIndex !== -1 ? path.substring(lastSlashIndex + 1) : path;\n\n\t\treturn filename.replace(/\\.md$/i, \"\");\n\t}\n\n\t// Not a wiki link, treat as regular path\n\tconst lastSlashIndex = trimmed.lastIndexOf(\"/\");\n\n\tconst filename = lastSlashIndex !== -1 ? trimmed.substring(lastSlashIndex + 1) : trimmed;\n\n\treturn filename.replace(/\\.md$/i, \"\");\n}\n\n/**\n * Extracts the actual file path from a wiki link or returns the path as-is.\n *\n * Handles:\n * - `[[path/to/file|Alias]]` -> returns \"path/to/file.md\"\n * - `[[path/to/file]]` -> returns \"path/to/file.md\"\n * - `path/to/file.md` -> returns \"path/to/file.md\"\n *\n * @param input - File path or wiki link string\n * @returns The actual file path (with .md extension)\n */\nexport function extractFilePath(input: string): string {\n\tif (!input) return \"\";\n\n\tconst trimmed = input.trim();\n\n\t// Check if it's a wiki link format [[path|alias]] or [[path]]\n\tconst wikiLinkMatch = trimmed.match(/^\\[\\[([^\\]]+)\\]\\]$/);\n\n\tif (wikiLinkMatch) {\n\t\tconst innerContent = wikiLinkMatch[1];\n\n\t\t// Check if there's an alias (pipe character)\n\t\tconst pipeIndex = innerContent.indexOf(\"|\");\n\n\t\tconst path =\n\t\t\tpipeIndex !== -1 ? innerContent.substring(0, pipeIndex).trim() : innerContent.trim();\n\n\t\t// Ensure .md extension\n\t\treturn path.endsWith(\".md\") ? path : `${path}.md`;\n\t}\n\n\t// Not a wiki link, ensure .md extension\n\treturn trimmed.endsWith(\".md\") ? trimmed : `${trimmed}.md`;\n}\n\n// ============================================================================\n// File Context\n// ============================================================================\n\nexport interface FileContext {\n\tpath: string;\n\tpathWithExt: string;\n\tbaseName: string;\n\tfile: TFile | null;\n\tfrontmatter: Record<string, any> | undefined;\n\tcache: CachedMetadata | null;\n}\n\n/**\n * Creates a comprehensive file context object containing all relevant file information.\n * Handles path normalization, file lookup, and metadata caching.\n */\nexport function getFileContext(app: App, path: string): FileContext {\n\tconst pathWithExt = ensureMarkdownExtension(path);\n\n\tconst baseName = removeMarkdownExtension(path);\n\n\tconst file = getFileByPath(app, pathWithExt);\n\n\tconst cache = file ? app.metadataCache.getFileCache(file) : null;\n\n\tconst frontmatter = cache?.frontmatter;\n\n\treturn {\n\t\tpath,\n\t\tpathWithExt,\n\t\tbaseName,\n\t\tfile,\n\t\tfrontmatter,\n\t\tcache,\n\t};\n}\n\n/**\n * Helper function to work with file context that automatically handles file not found cases.\n * Returns null if the file doesn't exist, otherwise executes the callback with the context.\n */\nexport async function withFileContext<T>(\n\tapp: App,\n\tpath: string,\n\tcallback: (context: FileContext) => Promise<T> | T\n): Promise<T | null> {\n\tconst context = getFileContext(app, path);\n\n\tif (!context.file) {\n\t\tconsole.warn(`File not found: ${context.pathWithExt}`);\n\t\treturn null;\n\t}\n\n\treturn await callback(context);\n}\n\n// ============================================================================\n// File Path Generation\n// ============================================================================\n\n/**\n * Generates a unique file path by appending a counter if the file already exists.\n * Automatically adds .md extension if not present.\n *\n * @param app - The Obsidian App instance\n * @param folder - Folder path (empty string for root, no trailing slash needed)\n * @param baseName - Base file name without extension\n * @returns Unique file path that doesn't exist in the vault\n *\n * @example\n * ```ts\n * // If \"MyNote.md\" exists, returns \"MyNote 1.md\"\n * const path = getUniqueFilePath(app, \"\", \"MyNote\");\n *\n * // With folder: \"Projects/Task.md\" -> \"Projects/Task 1.md\"\n * const path = getUniqueFilePath(app, \"Projects\", \"Task\");\n *\n * // Root folder handling\n * const path = getUniqueFilePath(app, \"/\", \"Note\"); // -> \"Note.md\"\n * ```\n */\nexport function getUniqueFilePath(app: App, folder: string, baseName: string): string {\n\tconst normalizedFolder = folder && folder !== \"/\" ? folder : \"\";\n\tconst folderPath = normalizedFolder ? `${normalizedFolder}/` : \"\";\n\n\tlet fileName = `${baseName}.md`;\n\tlet fullPath = `${folderPath}${fileName}`;\n\tlet counter = 1;\n\n\twhile (app.vault.getAbstractFileByPath(fullPath)) {\n\t\tfileName = `${baseName} ${counter}.md`;\n\t\tfullPath = `${folderPath}${fileName}`;\n\t\tcounter++;\n\t}\n\n\treturn fullPath;\n}\n\n/**\n * Generates a unique file path by appending a counter if the file already exists.\n * Accepts a complete file path and iterates with a counter suffix.\n *\n * @param app - The Obsidian App instance\n * @param filePath - Complete file path including folder, name, and extension\n * @returns Unique file path that doesn't exist in the vault\n *\n * @example\n * ```ts\n * // If \"folder/note.md\" exists, returns \"folder/note 1.md\"\n * const path = getUniqueFilePathFromFull(app, \"folder/note.md\");\n *\n * // Works with any extension\n * const path = getUniqueFilePathFromFull(app, \"assets/image.png\");\n * // -> \"assets/image 1.png\" if image.png exists\n * ```\n */\nexport const getUniqueFilePathFromFull = (app: App, filePath: string): string => {\n\t// If file doesn't exist, return as-is\n\tif (!app.vault.getAbstractFileByPath(filePath)) {\n\t\treturn filePath;\n\t}\n\n\t// Extract folder, base name, and extension\n\tconst lastSlashIndex = filePath.lastIndexOf(\"/\");\n\tconst folderPath = lastSlashIndex !== -1 ? filePath.substring(0, lastSlashIndex + 1) : \"\";\n\tconst fileName = lastSlashIndex !== -1 ? filePath.substring(lastSlashIndex + 1) : filePath;\n\n\tconst lastDotIndex = fileName.lastIndexOf(\".\");\n\tconst baseName = lastDotIndex !== -1 ? fileName.substring(0, lastDotIndex) : fileName;\n\tconst extension = lastDotIndex !== -1 ? fileName.substring(lastDotIndex) : \"\";\n\n\tlet counter = 1;\n\tlet uniquePath = `${folderPath}${baseName} ${counter}${extension}`;\n\n\twhile (app.vault.getAbstractFileByPath(uniquePath)) {\n\t\tcounter++;\n\t\tuniquePath = `${folderPath}${baseName} ${counter}${extension}`;\n\t}\n\n\treturn uniquePath;\n};\n\n/**\n * Generates a unique file path by appending a counter if the file already exists.\n * Supports custom file extensions.\n *\n * @param app - The Obsidian App instance\n * @param folder - Folder path (empty string for root)\n * @param baseName - Base file name without extension\n * @param extension - File extension (defaults to \"md\")\n * @returns Unique file path that doesn't exist in the vault\n */\nexport const generateUniqueFilePath = (\n\tapp: App,\n\tfolder: string,\n\tbaseName: string,\n\textension: string = \"md\"\n): string => {\n\tconst folderPath = folder ? `${folder}/` : \"\";\n\tconst fullPath = `${folderPath}${baseName}.${extension}`;\n\treturn getUniqueFilePathFromFull(app, fullPath);\n};\n\n// ============================================================================\n// Folder Note Operations\n// ============================================================================\n\n/**\n * Checks if a file is a folder note.\n * A folder note is a file whose name matches its parent folder name.\n *\n * @param filePath - Path to the file (e.g., \"tasks/tasks.md\")\n * @returns true if the file is a folder note, false otherwise\n *\n * @example\n * ```ts\n * isFolderNote(\"tasks/tasks.md\") // true\n * isFolderNote(\"tasks/subtask.md\") // false\n * isFolderNote(\"note.md\") // false (no parent folder)\n * isFolderNote(\"projects/docs/docs.md\") // true\n * ```\n */\nexport function isFolderNote(filePath: string): boolean {\n\tif (!filePath) return false;\n\n\t// Remove .md extension for comparison\n\tconst pathWithoutExt = removeMarkdownExtension(filePath);\n\n\t// Split path into segments\n\tconst segments = pathWithoutExt.split(\"/\");\n\n\t// Need at least 2 segments (folder/file)\n\tif (segments.length < 2) return false;\n\n\t// Get the file name (last segment) and parent folder name (second to last)\n\tconst fileName = segments[segments.length - 1];\n\tconst parentFolderName = segments[segments.length - 2];\n\n\t// File is a folder note if its name matches the parent folder\n\treturn fileName === parentFolderName;\n}\n\n/**\n * Gets the folder path for a file.\n *\n * @param filePath - Path to the file (e.g., \"tasks/subtask.md\")\n * @returns Folder path without trailing slash, or empty string if file is in root\n *\n * @example\n * ```ts\n * getFolderPath(\"tasks/subtask.md\") // \"tasks\"\n * getFolderPath(\"projects/docs/notes.md\") // \"projects/docs\"\n * getFolderPath(\"note.md\") // \"\"\n * ```\n */\nexport function getFolderPath(filePath: string): string {\n\tif (!filePath) return \"\";\n\n\tconst lastSlashIndex = filePath.lastIndexOf(\"/\");\n\n\tif (lastSlashIndex === -1) return \"\";\n\n\treturn filePath.substring(0, lastSlashIndex);\n}\n\n/**\n * Gets all markdown files in a specific folder (non-recursive).\n *\n * @param app - The Obsidian App instance\n * @param folderPath - Path to the folder (e.g., \"tasks\")\n * @returns Array of TFile objects in the folder\n *\n * @example\n * ```ts\n * const files = getFilesInFolder(app, \"tasks\");\n * // Returns [task1.md, task2.md, tasks.md] but not tasks/subtasks/file.md\n * ```\n */\nexport function getFilesInFolder(app: App, folderPath: string): TFile[] {\n\tconst allFiles = app.vault.getMarkdownFiles();\n\n\treturn allFiles.filter((file) => {\n\t\tconst fileFolder = getFolderPath(file.path);\n\n\t\treturn fileFolder === folderPath;\n\t});\n}\n\n/**\n * Gets all markdown files in a folder and its subfolders recursively.\n *\n * @param app - The Obsidian App instance\n * @param folderPath - Path to the folder (e.g., \"tasks\")\n * @returns Array of TFile objects in the folder tree\n *\n * @example\n * ```ts\n * const files = getAllFilesInFolderTree(app, \"tasks\");\n * // Returns all .md files in tasks/ and all its subdirectories\n * ```\n */\nexport function getAllFilesInFolderTree(app: App, folderPath: string): TFile[] {\n\tconst allFiles = app.vault.getMarkdownFiles();\n\n\tconst normalizedFolder = folderPath ? `${folderPath}/` : \"\";\n\n\treturn allFiles.filter((file) => {\n\t\tif (!normalizedFolder) return true; // Root folder includes all files\n\n\t\treturn file.path.startsWith(normalizedFolder);\n\t});\n}\n\n/**\n * Gets the parent file path based on folder structure.\n * For a file in a folder, the parent is the folder note if it exists.\n *\n * @param app - The Obsidian App instance\n * @param filePath - Path to the file\n * @returns Path to parent file, or null if no parent exists\n *\n * @example\n * ```ts\n * // If tasks/tasks.md exists\n * getParentByFolder(app, \"tasks/subtask.md\") // \"tasks/tasks.md\"\n *\n * // If parent folder note doesn't exist\n * getParentByFolder(app, \"tasks/subtask.md\") // null\n *\n * // Root level file\n * getParentByFolder(app, \"note.md\") // null\n * ```\n */\nexport function getParentByFolder(app: App, filePath: string): string | null {\n\tconst folderPath = getFolderPath(filePath);\n\n\tif (!folderPath) return null; // File is at root level\n\n\t// Check if folder note exists\n\tconst folderSegments = folderPath.split(\"/\");\n\n\tconst parentFolderName = folderSegments[folderSegments.length - 1];\n\n\tconst potentialParentPath = `${folderPath}/${parentFolderName}.md`;\n\n\tconst parentFile = getFileByPath(app, potentialParentPath);\n\n\treturn parentFile ? potentialParentPath : null;\n}\n\n/**\n * Gets all child file paths based on folder structure.\n * Works for both folder notes and regular files.\n *\n * For folder notes (e.g., \"tasks/tasks.md\"):\n * - Returns all files directly in the folder (excluding the folder note)\n * - Includes subfolder notes one level down\n *\n * For regular files (e.g., \"tasks/task1.md\"):\n * - Returns the folder note from matching subfolder if it exists (e.g., \"tasks/task1/task1.md\")\n *\n * @param app - The Obsidian App instance\n * @param filePath - Path to the file\n * @returns Array of child file paths\n *\n * @example\n * ```ts\n * // For tasks/tasks.md (folder note)\n * getChildrenByFolder(app, \"tasks/tasks.md\")\n * // Returns [\"tasks/task1.md\", \"tasks/task2.md\", \"tasks/subtasks/subtasks.md\"]\n *\n * // For tasks/task1.md (regular file with matching subfolder)\n * getChildrenByFolder(app, \"tasks/task1.md\")\n * // Returns [\"tasks/task1/task1.md\"] if it exists\n * ```\n */\nexport function getChildrenByFolder(app: App, filePath: string): string[] {\n\tconst allFiles = app.vault.getMarkdownFiles();\n\n\t// Case 1: Folder note - get all files in the folder\n\tif (isFolderNote(filePath)) {\n\t\tconst folderPath = getFolderPath(filePath);\n\n\t\tconst children: string[] = [];\n\n\t\tallFiles.forEach((file) => {\n\t\t\t// Skip the folder note itself\n\t\t\tif (file.path === filePath) return;\n\n\t\t\tconst fileFolder = getFolderPath(file.path);\n\n\t\t\t// Direct child: file is in the same folder as the folder note\n\t\t\tif (fileFolder === folderPath) {\n\t\t\t\tchildren.push(file.path);\n\n\t\t\t\treturn;\n\t\t\t}\n\n\t\t\t// Subfolder note: file is a folder note one level deeper\n\t\t\t// e.g., for \"tasks/tasks.md\", include \"tasks/subtasks/subtasks.md\"\n\t\t\tif (fileFolder.startsWith(`${folderPath}/`)) {\n\t\t\t\t// Check if it's exactly one level deeper and is a folder note\n\t\t\t\tconst relativePath = fileFolder.substring(folderPath.length + 1);\n\n\t\t\t\tconst isOneLevel = !relativePath.includes(\"/\");\n\n\t\t\t\tif (isOneLevel && isFolderNote(file.path)) {\n\t\t\t\t\tchildren.push(file.path);\n\t\t\t\t}\n\t\t\t}\n\t\t});\n\n\t\treturn children;\n\t}\n\n\t// Case 2: Regular file - check for matching subfolder with folder note\n\tconst pathWithoutExt = removeMarkdownExtension(filePath);\n\n\tconst fileName = pathWithoutExt.split(\"/\").pop() || \"\";\n\n\tconst potentialChildFolder = `${pathWithoutExt}`;\n\n\tconst potentialChildPath = `${potentialChildFolder}/${fileName}.md`;\n\n\t// Check if the child folder note exists\n\tconst childFile = getFileByPath(app, potentialChildPath);\n\n\treturn childFile ? [potentialChildPath] : [];\n}\n\n/**\n * Finds all root nodes in a folder tree.\n * Root nodes are files at the top level of the folder (directly in the folder, not in subfolders).\n *\n * @param app - The Obsidian App instance\n * @param folderPath - Path to the folder\n * @returns Array of root file paths\n *\n * @example\n * ```ts\n * // For folder structure:\n * // tasks/\n * //   tasks.md (folder note)\n * //   task1.md\n * //   subtasks/\n * //     subtasks.md\n * //     subtask1.md\n *\n * findRootNodesInFolder(app, \"tasks\")\n * // Returns [\"tasks/tasks.md\", \"tasks/task1.md\"]\n * // Excludes subtasks/subtasks.md and subtasks/subtask1.md (they're in subfolder)\n * ```\n */\nexport function findRootNodesInFolder(app: App, folderPath: string): string[] {\n\treturn getFilesInFolder(app, folderPath).map((file) => file.path);\n}\n\n// ============================================================================\n// Filename Sanitization\n// ============================================================================\n\nexport interface SanitizeFilenameOptions {\n\t/**\n\t * Style of sanitization to apply.\n\t * - \"kebab\": Convert to lowercase, replace spaces with hyphens (default, backwards compatible)\n\t * - \"preserve\": Preserve spaces and case, only remove invalid characters\n\t */\n\tstyle?: \"kebab\" | \"preserve\";\n}\n\n/**\n * Sanitizes a string for use as a filename.\n * Defaults to kebab-case style for backwards compatibility.\n *\n * @param input - String to sanitize\n * @param options - Sanitization options\n * @returns Sanitized filename string\n *\n * @example\n * // Default kebab-case style (backwards compatible)\n * sanitizeForFilename(\"My File Name\") // \"my-file-name\"\n *\n * // Preserve spaces and case\n * sanitizeForFilename(\"My File Name\", { style: \"preserve\" }) // \"My File Name\"\n */\nexport const sanitizeForFilename = (\n\tinput: string,\n\toptions: SanitizeFilenameOptions = {}\n): string => {\n\tconst { style = \"kebab\" } = options;\n\n\tif (style === \"preserve\") {\n\t\treturn sanitizeFilenamePreserveSpaces(input);\n\t}\n\n\t// Default: kebab-case style (legacy behavior)\n\treturn sanitizeFilenameKebabCase(input);\n};\n\n/**\n * Sanitizes filename using kebab-case style.\n * - Removes invalid characters\n * - Converts to lowercase\n * - Replaces spaces with hyphens\n *\n * Best for: CLI tools, URLs, slugs, technical files\n *\n * @example\n * sanitizeFilenameKebabCase(\"My File Name\") // \"my-file-name\"\n * sanitizeFilenameKebabCase(\"Travel Around The World\") // \"travel-around-the-world\"\n */\nexport const sanitizeFilenameKebabCase = (input: string): string => {\n\treturn (\n\t\tinput\n\t\t\t// Remove invalid filename characters\n\t\t\t.replace(/[<>:\"/\\\\|?*]/g, \"\")\n\t\t\t// Replace spaces with hyphens\n\t\t\t.replace(/\\s+/g, \"-\")\n\t\t\t// Replace multiple hyphens with single\n\t\t\t.replace(/-+/g, \"-\")\n\t\t\t// Remove leading/trailing hyphens\n\t\t\t.replace(/^-|-$/g, \"\")\n\t\t\t// Convert to lowercase\n\t\t\t.toLowerCase()\n\t);\n};\n\n/**\n * Sanitizes filename while preserving spaces and case.\n * - Removes invalid characters only\n * - Preserves spaces and original casing\n * - Removes trailing dots (Windows compatibility)\n *\n * Best for: Note titles, human-readable filenames, Obsidian notes\n *\n * @example\n * sanitizeFilenamePreserveSpaces(\"My File Name\") // \"My File Name\"\n * sanitizeFilenamePreserveSpaces(\"Travel Around The World\") // \"Travel Around The World\"\n * sanitizeFilenamePreserveSpaces(\"File<Invalid>Chars\") // \"FileInvalidChars\"\n */\nexport const sanitizeFilenamePreserveSpaces = (input: string): string => {\n\treturn (\n\t\tinput\n\t\t\t// Remove invalid filename characters (cross-platform compatibility)\n\t\t\t.replace(/[<>:\"/\\\\|?*]/g, \"\")\n\t\t\t// Remove trailing dots (invalid on Windows)\n\t\t\t.replace(/\\.+$/g, \"\")\n\t\t\t// Remove leading/trailing whitespace\n\t\t\t.trim()\n\t);\n};\n\nexport const getFilenameFromPath = (filePath: string): string => {\n\treturn filePath.split(\"/\").pop() || \"Unknown\";\n};\n\nexport const isFileInConfiguredDirectory = (filePath: string, directory: string): boolean => {\n\tconst normalizedDir = directory.endsWith(\"/\") ? directory.slice(0, -1) : directory;\n\treturn filePath.startsWith(`${normalizedDir}/`) || filePath === normalizedDir;\n};\n"]}

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

@@ -1,38 +0,0 @@
-export type Frontmatter = Record<string, unknown>;
-export interface FrontmatterChange {
-    key: string;
-    oldValue: unknown;
-    newValue: unknown;
-    changeType: "added" | "modified" | "deleted";
-}
-export interface FrontmatterDiff {
-    hasChanges: boolean;
-    changes: FrontmatterChange[];
-    added: FrontmatterChange[];
-    modified: FrontmatterChange[];
-    deleted: FrontmatterChange[];
-}
-/**
- * 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 declare function compareFrontmatter(oldFrontmatter: Frontmatter, newFrontmatter: Frontmatter, excludeProps?: Set<string>): FrontmatterDiff;
-/**
- * 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 declare function mergeFrontmatterDiffs(diffs: FrontmatterDiff[]): FrontmatterDiff;
-/**
- * Formats a frontmatter change for display in a modal.
- * Returns a human-readable string describing the change.
- */
-export declare function formatChangeForDisplay(change: FrontmatterChange): string;
-//# sourceMappingURL=frontmatter-diff.d.ts.map