@real1ty-obsidian-plugins/utils 2.29.0 → 2.30.0

package/dist/file/file-operations.js

@@ -1,160 +0,0 @@
-import { __awaiter } from "tslib";
-import * as fs from "node:fs/promises";
-import * as path from "node:path";
-import { Notice, TFile } from "obsidian";
-import { generateZettelId } from "../core";
-import { generateUniqueFilePath } from "./file";
-import { extractFilePathFromLink } from "./link-parser";
-export const fromRoot = (relativePath) => {
-    return path.resolve(__dirname, `../../../${relativePath}`);
-};
-export const getActiveFileOrThrow = (app) => {
-    const activeFile = app.workspace.getActiveFile();
-    if (!activeFile) {
-        new Notice(`⚠️  Open a note first.`);
-        throw new Error(`Open a note first.`);
-    }
-    return activeFile;
-};
-export const getTemplateContent = (app, templatePath) => __awaiter(void 0, void 0, void 0, function* () {
-    const templateFile = app.vault.getAbstractFileByPath(templatePath);
-    if (!templateFile) {
-        new Notice(`❌  Template not found: ${templatePath}`);
-        throw new Error(`Template not found: ${templatePath}`);
-    }
-    return yield app.vault.read(templateFile);
-});
-export const ensureFolderExists = (app, folderPath) => __awaiter(void 0, void 0, void 0, function* () {
-    if (!app.vault.getAbstractFileByPath(folderPath)) {
-        yield app.vault.createFolder(folderPath).catch(() => { });
-    }
-});
-export const openFileInNewLeaf = (app, file) => __awaiter(void 0, void 0, void 0, function* () {
-    yield app.workspace.getLeaf(true).openFile(file);
-});
-export const getNoteFilesFromDir = (directoryPath) => __awaiter(void 0, void 0, void 0, function* () {
-    const files = yield fs.readdir(directoryPath);
-    const directoryName = path.basename(directoryPath);
-    return files.filter((file) => {
-        if (!file.endsWith(".md"))
-            return false;
-        const fileNameWithoutExt = path.parse(file).name;
-        if (fileNameWithoutExt === directoryName) {
-            console.log(`⏭️ Skipping directory-level file: ${file}`);
-            return false;
-        }
-        return true;
-    });
-});
-export const getTargetFileFromLink = (app, relationshipLink) => {
-    const targetFilePath = extractFilePathFromLink(relationshipLink);
-    if (!targetFilePath) {
-        console.warn(`Failed to extract file path from link: ${relationshipLink}`);
-        return null;
-    }
-    const targetFile = app.vault.getAbstractFileByPath(targetFilePath);
-    if (!targetFile) {
-        console.warn(`Target file not found for link: ${relationshipLink}`);
-        return null;
-    }
-    return targetFile;
-};
-export const createFileLink = (file) => {
-    var _a;
-    const folder = ((_a = file.parent) === null || _a === void 0 ? void 0 : _a.path) && file.parent.path !== "/" ? file.parent.path : "";
-    return folder ? `[[${folder}/${file.basename}|${file.basename}]]` : `[[${file.basename}]]`;
-};
-export const normalizeArray = (value) => {
-    if (!value) {
-        return [];
-    }
-    if (typeof value === "string") {
-        return [value];
-    }
-    if (Array.isArray(value)) {
-        return value;
-    }
-    return [];
-};
-export const arraysEqual = (a, b) => {
-    return a.length === b.length && a.every((val, index) => val === b[index]);
-};
-/**
- * Normalizes frontmatter content by converting quoted numeric _ZettelIDs to numbers.
- * This handles edge cases where YAML parsers treat numeric strings inconsistently.
- */
-export const normalizeContent = (content) => {
-    let normalized = content;
-    let hasChanges = false;
-    // Normalize _ZettelID: "string" → number (remove quotes)
-    const zettelIdMatch = normalized.match(/^_ZettelID:\s*"(\d+)"/m);
-    if (zettelIdMatch) {
-        const [fullMatch, numericId] = zettelIdMatch;
-        const replacement = `_ZettelID: ${numericId}`;
-        normalized = normalized.replace(fullMatch, replacement);
-        hasChanges = true;
-        console.log(`  ✅ _ZettelID: "${numericId}" → ${numericId}`);
-    }
-    return hasChanges ? normalized : content;
-};
-/**
- * Safely performs a file operation with error handling and file validation.
- * Reduces boilerplate for common file operations.
- */
-export const withFileOperation = (app_1, event_1, operation_1, ...args_1) => __awaiter(void 0, [app_1, event_1, operation_1, ...args_1], void 0, function* (app, event, operation, errorMessage = "Operation failed") {
-    try {
-        const filePath = event.extendedProps.filePath;
-        const file = app.vault.getAbstractFileByPath(filePath);
-        if (!(file instanceof TFile)) {
-            new Notice("Could not find the file");
-            return null;
-        }
-        return yield operation(file);
-    }
-    catch (error) {
-        console.error(`Error in file operation:`, error);
-        new Notice(errorMessage);
-        return null;
-    }
-});
-/**
- * Safely performs a file operation by file path with error handling and file validation.
- */
-export const withFile = (app_1, filePath_1, operation_1, ...args_1) => __awaiter(void 0, [app_1, filePath_1, operation_1, ...args_1], void 0, function* (app, filePath, operation, errorMessage = "Operation failed") {
-    try {
-        const file = app.vault.getAbstractFileByPath(filePath);
-        if (!(file instanceof TFile)) {
-            new Notice("Could not find the file");
-            return null;
-        }
-        return yield operation(file);
-    }
-    catch (error) {
-        console.error(`Error in file operation:`, error);
-        new Notice(errorMessage);
-        return null;
-    }
-});
-/**
- * Duplicates a file with a new ZettelID, preserving the original content
- * but updating the ZettelID in frontmatter if configured.
- */
-export const duplicateFileWithNewZettelId = (app, file, zettelIdProp) => __awaiter(void 0, void 0, void 0, function* () {
-    var _a;
-    const content = yield app.vault.read(file);
-    const parentPath = ((_a = file.parent) === null || _a === void 0 ? void 0 : _a.path) || "";
-    const baseNameWithoutZettel = file.basename.replace(/-\d{14}$/, "");
-    const zettelId = generateZettelId();
-    const newBasename = `${baseNameWithoutZettel}-${zettelId}`;
-    const newFilePath = generateUniqueFilePath(app, parentPath, newBasename);
-    // Create the new file with original content
-    const newFile = yield app.vault.create(newFilePath, content);
-    // Update the ZettelID in frontmatter if configured
-    if (zettelIdProp) {
-        yield app.fileManager.processFrontMatter(newFile, (fm) => {
-            fm[zettelIdProp] = zettelId;
-        });
-    }
-    return newFile;
-});
-//# sourceMappingURL=file-operations.js.map

package/dist/file/file-operations.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"file-operations.js","sourceRoot":"","sources":["../../src/file/file-operations.ts"],"names":[],"mappings":"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","sourcesContent":["import * as fs from \"node:fs/promises\";\nimport * as path from \"node:path\";\nimport { type App, Notice, TFile } from \"obsidian\";\nimport { generateZettelId } from \"../core\";\nimport { generateUniqueFilePath } from \"./file\";\nimport { extractFilePathFromLink } from \"./link-parser\";\n\nexport const fromRoot = (relativePath: string): string => {\n\treturn path.resolve(__dirname, `../../../${relativePath}`);\n};\n\nexport const getActiveFileOrThrow = (app: App): TFile => {\n\tconst activeFile: TFile | null = app.workspace.getActiveFile();\n\tif (!activeFile) {\n\t\tnew Notice(`⚠️  Open a note first.`);\n\t\tthrow new Error(`Open a note first.`);\n\t}\n\treturn activeFile;\n};\n\nexport const getTemplateContent = async (app: App, templatePath: string): Promise<string> => {\n\tconst templateFile = app.vault.getAbstractFileByPath(templatePath);\n\tif (!templateFile) {\n\t\tnew Notice(`❌  Template not found: ${templatePath}`);\n\t\tthrow new Error(`Template not found: ${templatePath}`);\n\t}\n\n\treturn await app.vault.read(templateFile as TFile);\n};\n\nexport const ensureFolderExists = async (app: App, folderPath: string): Promise<void> => {\n\tif (!app.vault.getAbstractFileByPath(folderPath)) {\n\t\tawait app.vault.createFolder(folderPath).catch(() => {});\n\t}\n};\n\nexport const openFileInNewLeaf = async (app: App, file: TFile): Promise<void> => {\n\tawait app.workspace.getLeaf(true).openFile(file);\n};\n\nexport const getNoteFilesFromDir = async (directoryPath: string): Promise<string[]> => {\n\tconst files = await fs.readdir(directoryPath);\n\tconst directoryName = path.basename(directoryPath);\n\n\treturn files.filter((file) => {\n\t\tif (!file.endsWith(\".md\")) return false;\n\n\t\tconst fileNameWithoutExt = path.parse(file).name;\n\t\tif (fileNameWithoutExt === directoryName) {\n\t\t\tconsole.log(`⏭️ Skipping directory-level file: ${file}`);\n\t\t\treturn false;\n\t\t}\n\n\t\treturn true;\n\t});\n};\n\nexport const getTargetFileFromLink = (app: App, relationshipLink: string): TFile | null => {\n\tconst targetFilePath = extractFilePathFromLink(relationshipLink);\n\tif (!targetFilePath) {\n\t\tconsole.warn(`Failed to extract file path from link: ${relationshipLink}`);\n\t\treturn null;\n\t}\n\n\tconst targetFile = app.vault.getAbstractFileByPath(targetFilePath) as TFile;\n\tif (!targetFile) {\n\t\tconsole.warn(`Target file not found for link: ${relationshipLink}`);\n\t\treturn null;\n\t}\n\n\treturn targetFile;\n};\n\nexport const createFileLink = (file: TFile): string => {\n\tconst folder = file.parent?.path && file.parent.path !== \"/\" ? file.parent.path : \"\";\n\treturn folder ? `[[${folder}/${file.basename}|${file.basename}]]` : `[[${file.basename}]]`;\n};\n\nexport const normalizeArray = (value: string | string[] | undefined): string[] => {\n\tif (!value) {\n\t\treturn [];\n\t}\n\tif (typeof value === \"string\") {\n\t\treturn [value];\n\t}\n\tif (Array.isArray(value)) {\n\t\treturn value;\n\t}\n\treturn [];\n};\n\nexport const arraysEqual = (a: string[], b: string[]): boolean => {\n\treturn a.length === b.length && a.every((val, index) => val === b[index]);\n};\n\n/**\n * Normalizes frontmatter content by converting quoted numeric _ZettelIDs to numbers.\n * This handles edge cases where YAML parsers treat numeric strings inconsistently.\n */\nexport const normalizeContent = (content: string): string => {\n\tlet normalized = content;\n\tlet hasChanges = false;\n\n\t// Normalize _ZettelID: \"string\" → number (remove quotes)\n\tconst zettelIdMatch = normalized.match(/^_ZettelID:\\s*\"(\\d+)\"/m);\n\tif (zettelIdMatch) {\n\t\tconst [fullMatch, numericId] = zettelIdMatch;\n\t\tconst replacement = `_ZettelID: ${numericId}`;\n\t\tnormalized = normalized.replace(fullMatch, replacement);\n\t\thasChanges = true;\n\t\tconsole.log(`  ✅ _ZettelID: \"${numericId}\" → ${numericId}`);\n\t}\n\n\treturn hasChanges ? normalized : content;\n};\n\n/**\n * Safely performs a file operation with error handling and file validation.\n * Reduces boilerplate for common file operations.\n */\nexport const withFileOperation = async <T>(\n\tapp: App,\n\tevent: any,\n\toperation: (file: TFile) => Promise<T>,\n\terrorMessage: string = \"Operation failed\"\n): Promise<T | null> => {\n\ttry {\n\t\tconst filePath = event.extendedProps.filePath;\n\t\tconst file = app.vault.getAbstractFileByPath(filePath);\n\n\t\tif (!(file instanceof TFile)) {\n\t\t\tnew Notice(\"Could not find the file\");\n\t\t\treturn null;\n\t\t}\n\n\t\treturn await operation(file);\n\t} catch (error) {\n\t\tconsole.error(`Error in file operation:`, error);\n\t\tnew Notice(errorMessage);\n\t\treturn null;\n\t}\n};\n\n/**\n * Safely performs a file operation by file path with error handling and file validation.\n */\nexport const withFile = async <T>(\n\tapp: App,\n\tfilePath: string,\n\toperation: (file: TFile) => Promise<T>,\n\terrorMessage: string = \"Operation failed\"\n): Promise<T | null> => {\n\ttry {\n\t\tconst file = app.vault.getAbstractFileByPath(filePath);\n\n\t\tif (!(file instanceof TFile)) {\n\t\t\tnew Notice(\"Could not find the file\");\n\t\t\treturn null;\n\t\t}\n\n\t\treturn await operation(file);\n\t} catch (error) {\n\t\tconsole.error(`Error in file operation:`, error);\n\t\tnew Notice(errorMessage);\n\t\treturn null;\n\t}\n};\n\n/**\n * Duplicates a file with a new ZettelID, preserving the original content\n * but updating the ZettelID in frontmatter if configured.\n */\nexport const duplicateFileWithNewZettelId = async (\n\tapp: App,\n\tfile: TFile,\n\tzettelIdProp?: string\n): Promise<TFile> => {\n\tconst content = await app.vault.read(file);\n\n\tconst parentPath = file.parent?.path || \"\";\n\tconst baseNameWithoutZettel = file.basename.replace(/-\\d{14}$/, \"\");\n\tconst zettelId = generateZettelId();\n\tconst newBasename = `${baseNameWithoutZettel}-${zettelId}`;\n\tconst newFilePath = generateUniqueFilePath(app, parentPath, newBasename);\n\n\t// Create the new file with original content\n\tconst newFile = await app.vault.create(newFilePath, content);\n\n\t// Update the ZettelID in frontmatter if configured\n\tif (zettelIdProp) {\n\t\tawait app.fileManager.processFrontMatter(newFile, (fm) => {\n\t\t\tfm[zettelIdProp] = zettelId;\n\t\t});\n\t}\n\n\treturn newFile;\n};\n"]}

package/dist/file/file-utils.d.ts

@@ -1,33 +0,0 @@
-import type { App } from "obsidian";
-import { TFile } from "obsidian";
-/**
- * Waits for a file to be accessible and readable by Obsidian's cache.
- * This is necessary because Templater creates files asynchronously.
- */
-export declare function waitForFileReady(app: App, filePath: string, timeoutMs?: number): Promise<TFile | null>;
-/**
- * Gets a TFile by path or throws an error if not found.
- * Useful when you need to ensure a file exists before proceeding.
- */
-export declare const getTFileOrThrow: (app: App, path: string) => TFile;
-/**
- * Executes an operation on a file's frontmatter.
- * Wrapper around Obsidian's processFrontMatter for more concise usage.
- */
-export declare const withFrontmatter: (app: App, file: TFile, update: (fm: Record<string, unknown>) => void) => Promise<void>;
-/**
- * Creates a backup copy of a file's frontmatter.
- * Useful for undo/redo operations or temporary modifications.
- */
-export declare const backupFrontmatter: (app: App, file: TFile) => Promise<Record<string, unknown>>;
-/**
- * Restores a file's frontmatter from a backup.
- * Clears existing frontmatter and replaces with the backup.
- */
-export declare const restoreFrontmatter: (app: App, file: TFile, original: Record<string, unknown>) => Promise<void>;
-/**
- * Extracts the content that appears after the frontmatter section.
- * Returns the entire content if no frontmatter is found.
- */
-export declare const extractContentAfterFrontmatter: (fullContent: string) => string;
-//# sourceMappingURL=file-utils.d.ts.map

package/dist/file/file-utils.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"file-utils.d.ts","sourceRoot":"","sources":["../../src/file/file-utils.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,UAAU,CAAC;AACpC,OAAO,EAAE,KAAK,EAAE,MAAM,UAAU,CAAC;AAEjC;;;GAGG;AACH,wBAAsB,gBAAgB,CACrC,GAAG,EAAE,GAAG,EACR,QAAQ,EAAE,MAAM,EAChB,SAAS,SAAO,GACd,OAAO,CAAC,KAAK,GAAG,IAAI,CAAC,CAgBvB;AAED;;;GAGG;AACH,eAAO,MAAM,eAAe,GAAI,KAAK,GAAG,EAAE,MAAM,MAAM,KAAG,KAIxD,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,eAAe,GAC3B,KAAK,GAAG,EACR,MAAM,KAAK,EACX,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,kBACO,CAAC;AAEtD;;;GAGG;AACH,eAAO,MAAM,iBAAiB,GAAU,KAAK,GAAG,EAAE,MAAM,KAAK,qCAM5D,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,kBAAkB,GAC9B,KAAK,GAAG,EACR,MAAM,KAAK,EACX,UAAU,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,kBAO/B,CAAC;AAEJ;;;GAGG;AACH,eAAO,MAAM,8BAA8B,GAAI,aAAa,MAAM,KAAG,MAWpE,CAAC"}

package/dist/file/file-utils.js

@@ -1,76 +0,0 @@
-import { __awaiter } from "tslib";
-import { TFile } from "obsidian";
-/**
- * Waits for a file to be accessible and readable by Obsidian's cache.
- * This is necessary because Templater creates files asynchronously.
- */
-export function waitForFileReady(app_1, filePath_1) {
-    return __awaiter(this, arguments, void 0, function* (app, filePath, timeoutMs = 5000) {
-        const started = Date.now();
-        while (Date.now() - started < timeoutMs) {
-            const file = app.vault.getAbstractFileByPath(filePath);
-            if (file instanceof TFile) {
-                // Check if file is readable by trying to get its metadata
-                const metadata = app.metadataCache.getFileCache(file);
-                if (metadata !== null && metadata !== undefined) {
-                    return file;
-                }
-            }
-            yield new Promise((r) => setTimeout(r, 50));
-        }
-        return null;
-    });
-}
-/**
- * Gets a TFile by path or throws an error if not found.
- * Useful when you need to ensure a file exists before proceeding.
- */
-export const getTFileOrThrow = (app, path) => {
-    const f = app.vault.getAbstractFileByPath(path);
-    if (!(f instanceof TFile))
-        throw new Error(`File not found: ${path}`);
-    return f;
-};
-/**
- * Executes an operation on a file's frontmatter.
- * Wrapper around Obsidian's processFrontMatter for more concise usage.
- */
-export const withFrontmatter = (app, file, update) => __awaiter(void 0, void 0, void 0, function* () { return app.fileManager.processFrontMatter(file, update); });
-/**
- * Creates a backup copy of a file's frontmatter.
- * Useful for undo/redo operations or temporary modifications.
- */
-export const backupFrontmatter = (app, file) => __awaiter(void 0, void 0, void 0, function* () {
-    let copy = {};
-    yield withFrontmatter(app, file, (fm) => {
-        copy = Object.assign({}, fm);
-    });
-    return copy;
-});
-/**
- * Restores a file's frontmatter from a backup.
- * Clears existing frontmatter and replaces with the backup.
- */
-export const restoreFrontmatter = (app, file, original) => __awaiter(void 0, void 0, void 0, function* () {
-    return withFrontmatter(app, file, (fm) => {
-        for (const k of Object.keys(fm)) {
-            delete fm[k];
-        }
-        Object.assign(fm, original);
-    });
-});
-/**
- * Extracts the content that appears after the frontmatter section.
- * Returns the entire content if no frontmatter is found.
- */
-export const extractContentAfterFrontmatter = (fullContent) => {
-    const frontmatterRegex = /^---\s*\n([\s\S]*?)\n---\s*\n/;
-    const match = fullContent.match(frontmatterRegex);
-    if (match) {
-        // Return content after frontmatter
-        return fullContent.substring(match.index + match[0].length);
-    }
-    // If no frontmatter found, return the entire content
-    return fullContent;
-};
-//# sourceMappingURL=file-utils.js.map

package/dist/file/file-utils.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"file-utils.js","sourceRoot":"","sources":["../../src/file/file-utils.ts"],"names":[],"mappings":"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","sourcesContent":["import type { App } from \"obsidian\";\nimport { TFile } from \"obsidian\";\n\n/**\n * Waits for a file to be accessible and readable by Obsidian's cache.\n * This is necessary because Templater creates files asynchronously.\n */\nexport async function waitForFileReady(\n\tapp: App,\n\tfilePath: string,\n\ttimeoutMs = 5000\n): Promise<TFile | null> {\n\tconst started = Date.now();\n\n\twhile (Date.now() - started < timeoutMs) {\n\t\tconst file = app.vault.getAbstractFileByPath(filePath);\n\t\tif (file instanceof TFile) {\n\t\t\t// Check if file is readable by trying to get its metadata\n\t\t\tconst metadata = app.metadataCache.getFileCache(file);\n\t\t\tif (metadata !== null && metadata !== undefined) {\n\t\t\t\treturn file;\n\t\t\t}\n\t\t}\n\t\tawait new Promise((r) => setTimeout(r, 50));\n\t}\n\n\treturn null;\n}\n\n/**\n * Gets a TFile by path or throws an error if not found.\n * Useful when you need to ensure a file exists before proceeding.\n */\nexport const getTFileOrThrow = (app: App, path: string): TFile => {\n\tconst f = app.vault.getAbstractFileByPath(path);\n\tif (!(f instanceof TFile)) throw new Error(`File not found: ${path}`);\n\treturn f;\n};\n\n/**\n * Executes an operation on a file's frontmatter.\n * Wrapper around Obsidian's processFrontMatter for more concise usage.\n */\nexport const withFrontmatter = async (\n\tapp: App,\n\tfile: TFile,\n\tupdate: (fm: Record<string, unknown>) => void\n) => app.fileManager.processFrontMatter(file, update);\n\n/**\n * Creates a backup copy of a file's frontmatter.\n * Useful for undo/redo operations or temporary modifications.\n */\nexport const backupFrontmatter = async (app: App, file: TFile) => {\n\tlet copy: Record<string, unknown> = {};\n\tawait withFrontmatter(app, file, (fm) => {\n\t\tcopy = { ...fm };\n\t});\n\treturn copy;\n};\n\n/**\n * Restores a file's frontmatter from a backup.\n * Clears existing frontmatter and replaces with the backup.\n */\nexport const restoreFrontmatter = async (\n\tapp: App,\n\tfile: TFile,\n\toriginal: Record<string, unknown>\n) =>\n\twithFrontmatter(app, file, (fm) => {\n\t\tfor (const k of Object.keys(fm)) {\n\t\t\tdelete fm[k];\n\t\t}\n\t\tObject.assign(fm, original);\n\t});\n\n/**\n * Extracts the content that appears after the frontmatter section.\n * Returns the entire content if no frontmatter is found.\n */\nexport const extractContentAfterFrontmatter = (fullContent: string): string => {\n\tconst frontmatterRegex = /^---\\s*\\n([\\s\\S]*?)\\n---\\s*\\n/;\n\tconst match = fullContent.match(frontmatterRegex);\n\n\tif (match) {\n\t\t// Return content after frontmatter\n\t\treturn fullContent.substring(match.index! + match[0].length);\n\t}\n\n\t// If no frontmatter found, return the entire content\n\treturn fullContent;\n};\n"]}

package/dist/file/file.d.ts

@@ -1,332 +0,0 @@
-import type { App, CachedMetadata } from "obsidian";
-import { TFile } from "obsidian";
-/**
- * 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 declare function getFileByPath(app: App, filePath: string): TFile | 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 declare function ensureMarkdownExtension(path: string): string;
-/**
- * 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 declare function removeMarkdownExtension(path: string): string;
-/**
- * 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 declare function extractDisplayName(input: string): string;
-/**
- * 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 declare function extractFilePath(input: string): string;
-export interface FileContext {
-    path: string;
-    pathWithExt: string;
-    baseName: string;
-    file: TFile | null;
-    frontmatter: Record<string, any> | undefined;
-    cache: CachedMetadata | null;
-}
-/**
- * Creates a comprehensive file context object containing all relevant file information.
- * Handles path normalization, file lookup, and metadata caching.
- */
-export declare function getFileContext(app: App, path: string): FileContext;
-/**
- * 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 declare function withFileContext<T>(app: App, path: string, callback: (context: FileContext) => Promise<T> | T): Promise<T | null>;
-/**
- * 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 declare function getUniqueFilePath(app: App, folder: string, baseName: string): string;
-/**
- * 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 declare const getUniqueFilePathFromFull: (app: App, filePath: string) => string;
-/**
- * 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 declare const generateUniqueFilePath: (app: App, folder: string, baseName: string, extension?: string) => string;
-/**
- * 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 declare function isFolderNote(filePath: string): boolean;
-/**
- * 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 declare function getFolderPath(filePath: string): string;
-/**
- * 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 declare function getFilesInFolder(app: App, folderPath: string): TFile[];
-/**
- * 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 declare function getAllFilesInFolderTree(app: App, folderPath: string): TFile[];
-/**
- * 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 declare function getParentByFolder(app: App, filePath: string): string | 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 declare function getChildrenByFolder(app: App, filePath: string): string[];
-/**
- * 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 declare function findRootNodesInFolder(app: App, folderPath: string): string[];
-export interface SanitizeFilenameOptions {
-    /**
-     * Style of sanitization to apply.
-     * - "kebab": Convert to lowercase, replace spaces with hyphens (default, backwards compatible)
-     * - "preserve": Preserve spaces and case, only remove invalid characters
-     */
-    style?: "kebab" | "preserve";
-}
-/**
- * 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 declare const sanitizeForFilename: (input: string, options?: SanitizeFilenameOptions) => string;
-/**
- * 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 declare const sanitizeFilenameKebabCase: (input: string) => string;
-/**
- * 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 declare const sanitizeFilenamePreserveSpaces: (input: string) => string;
-export declare const getFilenameFromPath: (filePath: string) => string;
-export declare const isFileInConfiguredDirectory: (filePath: string, directory: string) => boolean;
-//# sourceMappingURL=file.d.ts.map

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

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