add execute file function

Author: mProjectsCode

exampleVault/Test.md

@@ -65,6 +65,28 @@ let lib = await self.require.import("lib.js");
 return lib.getGreeting();
 ```
 
+Run File:
+
+```js-engine
+const execution = await engine.internal.executeFile('testFile.js', {
+	container: container,
+	component: component,
+});
+const renderer = engine.internal.createRenderer(container, context.file.path, component);
+renderer.render(execution.result);
+container.createEl('p', {text: 'hello, this is rendered from this file'});
+```
+
+Without creating a renderer:
+
+```js-engine
+const execution = await engine.internal.executeFile('testFile.js', {
+	container: container,
+	component: component,
+});
+return execution.result
+```
+
 # Lib Test
 
 Importing packaged libraries works. In this example [parsiNOM](https://github.com/mProjectsCode/parsiNOM) is used.

exampleVault/testFile.js

@@ -0,0 +1,2 @@
+console.log('This is a test file');
+return engine.markdown.create('## This is Markdown Rendered from the Test File');

jsEngine/api/Internal.ts

@@ -1,7 +1,7 @@
 import { type API } from './API';
 import { type EngineExecutionParams } from '../engine/Engine';
 import { type JsExecution } from '../engine/JsExecution';
-import { type Component } from 'obsidian';
+import { type Component, TFile } from 'obsidian';
 import { ResultRenderer } from '../ResultRenderer';
 
 /**
@@ -14,11 +14,21 @@ export class InternalAPI {
 		this.apiInstance = apiInstance;
 	}
 
-	public async excute(params: EngineExecutionParams): Promise<JsExecution> {
+	public async execute(params: EngineExecutionParams): Promise<JsExecution> {
 		return await this.apiInstance.plugin.jsEngine.execute(params);
 	}
 
 	public createRenderer(container: HTMLElement, sourcePath: string, component: Component): ResultRenderer {
 		return new ResultRenderer(this.apiInstance.plugin, container, sourcePath, component);
 	}
+
+	public async executeFile(path: string, params: Omit<EngineExecutionParams, 'code'>): Promise<JsExecution> {
+		const file = this.apiInstance.app.vault.getAbstractFileByPath(path);
+		if (!file || !(file instanceof TFile)) {
+			throw new Error(`File ${path} not found.`);
+		}
+		const fullParams = params as EngineExecutionParams;
+		fullParams.code = await this.apiInstance.app.vault.read(file);
+		return await this.execute(fullParams);
+	}
 }