@real1ty-obsidian-plugins/utils 2.19.2 → 2.20.0

package/dist/file/index.d.ts

@@ -8,4 +8,5 @@ export * from "./frontmatter-propagation";
 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

@@ -1 +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,eAAe,CAAC;AAC9B,cAAc,kBAAkB,CAAC;AACjC,cAAc,aAAa,CAAC"}
+{"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,eAAe,CAAC;AAC9B,cAAc,kBAAkB,CAAC;AACjC,cAAc,aAAa,CAAC;AAC5B,cAAc,qBAAqB,CAAC"}

package/dist/file/index.js

@@ -8,4 +8,5 @@ export * from "./frontmatter-propagation";
 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

@@ -1 +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,eAAe,CAAC;AAC9B,cAAc,kBAAkB,CAAC;AACjC,cAAc,aAAa,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 \"./link-parser\";\nexport * from \"./property-utils\";\nexport * from \"./templater\";\n"]}
+{"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,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 \"./link-parser\";\nexport * from \"./property-utils\";\nexport * from \"./templater\";\nexport * from \"./templater-service\";\n"]}

package/dist/file/templater-service.d.ts

@@ -0,0 +1,18 @@
+import { type App, TFile } from "obsidian";
+import type { FileCreationOptions } from "./templater";
+export type { FileCreationOptions };
+export declare class TemplaterService {
+    private app;
+    constructor(app: App);
+    /**
+     * Checks if Templater plugin is installed and enabled.
+     */
+    isAvailable(): boolean;
+    /**
+     * Creates a file using Templater or falls back to manual creation.
+     */
+    createFile(options: FileCreationOptions): Promise<TFile>;
+    private shouldUseTemplate;
+    private createManually;
+}
+//# sourceMappingURL=templater-service.d.ts.map

package/dist/file/templater-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"templater-service.d.ts","sourceRoot":"","sources":["../../src/file/templater-service.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,GAAG,EAAE,KAAK,EAAE,MAAM,UAAU,CAAC;AAC3C,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAGvD,YAAY,EAAE,mBAAmB,EAAE,CAAC;AAMpC,qBAAa,gBAAgB;IAChB,OAAO,CAAC,GAAG;gBAAH,GAAG,EAAE,GAAG;IAE5B;;OAEG;IACH,WAAW,IAAI,OAAO;IAItB;;OAEG;IACG,UAAU,CAAC,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,KAAK,CAAC;IAmC9D,OAAO,CAAC,iBAAiB;YAIX,cAAc;CA8B5B"}

package/dist/file/templater-service.js

@@ -0,0 +1,70 @@
+import { __awaiter } from "tslib";
+import { TFile } from "obsidian";
+import { createFromTemplate, isTemplaterAvailable } from "./templater";
+// ============================================================================
+// Templater Service (Class-based wrapper)
+// ============================================================================
+export class TemplaterService {
+    constructor(app) {
+        this.app = app;
+    }
+    /**
+     * Checks if Templater plugin is installed and enabled.
+     */
+    isAvailable() {
+        return isTemplaterAvailable(this.app);
+    }
+    /**
+     * Creates a file using Templater or falls back to manual creation.
+     */
+    createFile(options) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const { title, targetDirectory, filename, content, frontmatter, templatePath, useTemplater } = options;
+            const finalFilename = filename || title;
+            // If content is provided, use manual creation to preserve the content
+            if (content) {
+                return this.createManually(title, targetDirectory, finalFilename, content, frontmatter);
+            }
+            // Try to use Templater if requested and available
+            if (useTemplater && templatePath && this.shouldUseTemplate(templatePath)) {
+                const templateFile = yield createFromTemplate(this.app, templatePath, targetDirectory, finalFilename);
+                if (templateFile) {
+                    // Apply frontmatter if provided
+                    if (frontmatter && Object.keys(frontmatter).length > 0) {
+                        yield this.app.fileManager.processFrontMatter(templateFile, (fm) => {
+                            Object.assign(fm, frontmatter);
+                        });
+                    }
+                    return templateFile;
+                }
+            }
+            // Fallback to manual creation
+            return this.createManually(title, targetDirectory, finalFilename, content, frontmatter);
+        });
+    }
+    shouldUseTemplate(templatePath) {
+        return !!(templatePath && this.isAvailable() && this.app.vault.getFileByPath(templatePath));
+    }
+    createManually(title, targetDirectory, filename, customContent, frontmatter) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const baseName = filename.replace(/\.md$/, "");
+            const filePath = `${targetDirectory}/${baseName}.md`;
+            // Check if file already exists
+            const existingFile = this.app.vault.getAbstractFileByPath(filePath);
+            if (existingFile instanceof TFile) {
+                return existingFile;
+            }
+            // Use custom content or default
+            const content = customContent || `# ${title}\n\n`;
+            const file = yield this.app.vault.create(filePath, content);
+            // Apply frontmatter if provided
+            if (frontmatter && Object.keys(frontmatter).length > 0) {
+                yield this.app.fileManager.processFrontMatter(file, (fm) => {
+                    Object.assign(fm, frontmatter);
+                });
+            }
+            return file;
+        });
+    }
+}
+//# sourceMappingURL=templater-service.js.map

package/dist/file/templater-service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"templater-service.js","sourceRoot":"","sources":["../../src/file/templater-service.ts"],"names":[],"mappings":"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","sourcesContent":["import { type App, TFile } from \"obsidian\";\nimport type { FileCreationOptions } from \"./templater\";\nimport { createFromTemplate, isTemplaterAvailable } from \"./templater\";\n\nexport type { FileCreationOptions };\n\n// ============================================================================\n// Templater Service (Class-based wrapper)\n// ============================================================================\n\nexport class TemplaterService {\n\tconstructor(private app: App) {}\n\n\t/**\n\t * Checks if Templater plugin is installed and enabled.\n\t */\n\tisAvailable(): boolean {\n\t\treturn isTemplaterAvailable(this.app);\n\t}\n\n\t/**\n\t * Creates a file using Templater or falls back to manual creation.\n\t */\n\tasync createFile(options: FileCreationOptions): Promise<TFile> {\n\t\tconst { title, targetDirectory, filename, content, frontmatter, templatePath, useTemplater } =\n\t\t\toptions;\n\n\t\tconst finalFilename = filename || title;\n\n\t\t// If content is provided, use manual creation to preserve the content\n\t\tif (content) {\n\t\t\treturn this.createManually(title, targetDirectory, finalFilename, content, frontmatter);\n\t\t}\n\n\t\t// Try to use Templater if requested and available\n\t\tif (useTemplater && templatePath && this.shouldUseTemplate(templatePath)) {\n\t\t\tconst templateFile = await createFromTemplate(\n\t\t\t\tthis.app,\n\t\t\t\ttemplatePath,\n\t\t\t\ttargetDirectory,\n\t\t\t\tfinalFilename\n\t\t\t);\n\n\t\t\tif (templateFile) {\n\t\t\t\t// Apply frontmatter if provided\n\t\t\t\tif (frontmatter && Object.keys(frontmatter).length > 0) {\n\t\t\t\t\tawait this.app.fileManager.processFrontMatter(templateFile, (fm) => {\n\t\t\t\t\t\tObject.assign(fm, frontmatter);\n\t\t\t\t\t});\n\t\t\t\t}\n\t\t\t\treturn templateFile;\n\t\t\t}\n\t\t}\n\n\t\t// Fallback to manual creation\n\t\treturn this.createManually(title, targetDirectory, finalFilename, content, frontmatter);\n\t}\n\n\tprivate shouldUseTemplate(templatePath: string): boolean {\n\t\treturn !!(templatePath && this.isAvailable() && this.app.vault.getFileByPath(templatePath));\n\t}\n\n\tprivate async createManually(\n\t\ttitle: string,\n\t\ttargetDirectory: string,\n\t\tfilename: string,\n\t\tcustomContent?: string,\n\t\tfrontmatter?: Record<string, unknown>\n\t): Promise<TFile> {\n\t\tconst baseName = filename.replace(/\\.md$/, \"\");\n\t\tconst filePath = `${targetDirectory}/${baseName}.md`;\n\n\t\t// Check if file already exists\n\t\tconst existingFile = this.app.vault.getAbstractFileByPath(filePath);\n\t\tif (existingFile instanceof TFile) {\n\t\t\treturn existingFile;\n\t\t}\n\n\t\t// Use custom content or default\n\t\tconst content = customContent || `# ${title}\\n\\n`;\n\n\t\tconst file = await this.app.vault.create(filePath, content);\n\n\t\t// Apply frontmatter if provided\n\t\tif (frontmatter && Object.keys(frontmatter).length > 0) {\n\t\t\tawait this.app.fileManager.processFrontMatter(file, (fm) => {\n\t\t\t\tObject.assign(fm, frontmatter);\n\t\t\t});\n\t\t}\n\n\t\treturn file;\n\t}\n}\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@real1ty-obsidian-plugins/utils",
-  "version": "2.19.2",
+  "version": "2.20.0",
   "description": "Shared utilities for Obsidian plugins",
   "type": "module",
   "main": "./dist/index.js",

package/src/file/index.ts

@@ -8,3 +8,4 @@ export * from "./frontmatter-propagation";
 export * from "./link-parser";
 export * from "./property-utils";
 export * from "./templater";
+export * from "./templater-service";

package/src/file/templater-service.ts

@@ -0,0 +1,93 @@
+import { type App, TFile } from "obsidian";
+import type { FileCreationOptions } from "./templater";
+import { createFromTemplate, isTemplaterAvailable } from "./templater";
+
+export type { FileCreationOptions };
+
+// ============================================================================
+// Templater Service (Class-based wrapper)
+// ============================================================================
+
+export class TemplaterService {
+	constructor(private app: App) {}
+
+	/**
+	 * Checks if Templater plugin is installed and enabled.
+	 */
+	isAvailable(): boolean {
+		return isTemplaterAvailable(this.app);
+	}
+
+	/**
+	 * Creates a file using Templater or falls back to manual creation.
+	 */
+	async createFile(options: FileCreationOptions): Promise<TFile> {
+		const { title, targetDirectory, filename, content, frontmatter, templatePath, useTemplater } =
+			options;
+
+		const finalFilename = filename || title;
+
+		// If content is provided, use manual creation to preserve the content
+		if (content) {
+			return this.createManually(title, targetDirectory, finalFilename, content, frontmatter);
+		}
+
+		// Try to use Templater if requested and available
+		if (useTemplater && templatePath && this.shouldUseTemplate(templatePath)) {
+			const templateFile = await createFromTemplate(
+				this.app,
+				templatePath,
+				targetDirectory,
+				finalFilename
+			);
+
+			if (templateFile) {
+				// Apply frontmatter if provided
+				if (frontmatter && Object.keys(frontmatter).length > 0) {
+					await this.app.fileManager.processFrontMatter(templateFile, (fm) => {
+						Object.assign(fm, frontmatter);
+					});
+				}
+				return templateFile;
+			}
+		}
+
+		// Fallback to manual creation
+		return this.createManually(title, targetDirectory, finalFilename, content, frontmatter);
+	}
+
+	private shouldUseTemplate(templatePath: string): boolean {
+		return !!(templatePath && this.isAvailable() && this.app.vault.getFileByPath(templatePath));
+	}
+
+	private async createManually(
+		title: string,
+		targetDirectory: string,
+		filename: string,
+		customContent?: string,
+		frontmatter?: Record<string, unknown>
+	): Promise<TFile> {
+		const baseName = filename.replace(/\.md$/, "");
+		const filePath = `${targetDirectory}/${baseName}.md`;
+
+		// Check if file already exists
+		const existingFile = this.app.vault.getAbstractFileByPath(filePath);
+		if (existingFile instanceof TFile) {
+			return existingFile;
+		}
+
+		// Use custom content or default
+		const content = customContent || `# ${title}\n\n`;
+
+		const file = await this.app.vault.create(filePath, content);
+
+		// Apply frontmatter if provided
+		if (frontmatter && Object.keys(frontmatter).length > 0) {
+			await this.app.fileManager.processFrontMatter(file, (fm) => {
+				Object.assign(fm, frontmatter);
+			});
+		}
+
+		return file;
+	}
+}