add lib api

Author: mProjectsCode

.gitignore

@@ -22,6 +22,7 @@ data.json
 .DS_Store
 
 obsidian.css
+index.d.ts
 
 !exampleVault/.obsidian
 

.prettierignore

@@ -5,3 +5,4 @@ exampleVault
 main.js
 Publish.js
 /docs
+index.d.ts

exampleVault/Dataview.md

@@ -1,5 +1,5 @@
 ---
-text: asdakdbg
+text: this is some text
 number: 12234234
 ---
 
@@ -49,77 +49,91 @@ return markdownBuilder
 
 # Import Test
 
+You can import JS files that lie inside of your vault.
+
+JS Engine version:
+
 ```js-engine
 let lib = await engine.importJs("lib.js");
 return lib.getGreeting();
 ```
 
+Modules Plugin version:
+
 ```js-engine
 let lib = await self.require.import("lib.js");
 return lib.getGreeting();
 ```
 
+# Lib Test
+
+Importing packaged libraries works. In this example [parsiNOM](https://github.com/mProjectsCode/parsiNOM) is used.
+
 ```js-engine
-let lib = await engine.importJs("svelte_project/dist/assets/index-9a060cab.js");
-console.log(lib);
-console.log(lib.App);
+let { P, P_UTILS } = engine.lib.parsinom();
+
+const parser = P.sequence(
+	P_UTILS.letters(), 
+	P_UTILS.digits()
+).map(
+	([a, b]) => b + a
+);
+
+return parser.parse("test123");
 ```
 
-# Async Test
+This example uses [IterTools](https://github.com/Smoren/itertools-ts).
 
 ```js-engine
-return await engine.test()
+let { Stream } = engine.lib.itertools();
+
+const result = Stream.of([1, 1, 2, 2, 3, 4, 5])
+	.distinct()             // [1, 2, 3, 4, 5]
+	.map((x) => x ** 2)     // [1, 4, 9, 16, 25]
+	.filter((x) => x < 10)  // [1, 4, 9]
+	.toSum();               // 14
+
+return result;
 ```
 
 # Meta Bind Test
 
+You can interact with other plugins APIs, in this example [Meta Bind](https://github.com/mProjectsCode/obsidian-meta-bind-plugin) is used.
+
 ```js-engine
-const meta_bind_api = engine.getPlugin("obsidian-meta-bind-plugin").api
+const mb = engine.getPlugin("obsidian-meta-bind-plugin").api
 
 const div1 = container.createDiv()
 const div2 = container.createDiv()
 
-const inputField = meta_bind_api.createInputFieldFromString("INPUT[text:text]", "INLINE", context.file.path, div1);
-const inputField2 = meta_bind_api.createInputFieldFromString("INPUT[number:number]", "INLINE", context.file.path, div2);
-
-component.addChild(inputField)
-component.addChild(inputField2)
+const inputField = mb.createInputFieldFromString("INPUT[text:text]", "INLINE", context.file.path, div1, component, undefined);
+const inputField2 = mb.createInputFieldFromString("INPUT[number:number]", "INLINE", context.file.path, div2, component, undefined);
 ```
 
-# Reactive Idea (TODO)
-
-```js
-// define a function that takes in some args and returns what should be rendered
-function render(args) {
-	return 'Something';
-}
-
-// create a reactive component, passing in the function and arguments for the initial render
-const reactive = engine.reactive(render, initialArgs);
+# Reactive Components
 
-// subscribe to events and call refresh with new arguments, which causes the render function to be rerun with these arguments, replacing the existing content
-event.on('...', (args) => reactive.refresh(args));
-
-// return the reactive component
-return reactive;
-```
+You can also create reactive components that re-render based on a specific event. In this case we subscribe to obsidians metadata cache.
 
 ```js-engine
 
+// define a function that takes in some args and returns what should be rendered
 function render(args) {
-	console.log(args)
 	return args?.text ?? "undefined";
 }
 
+// create a reactive component, passing in the function and arguments for the initial render
 const reactive = engine.reactive(render, context.metadata.frontmatter);
 
+// subscribe to events and call refresh with new arguments, which causes the render function to be rerun with these arguments, replacing the existing content
 const unloadCb = engine.app.metadataCache.on('changed', async (file, data, cache) => { 
 	if (file.path === context.file.path) { 
 		reactive.refresh(cache.frontmatter);
 	}
 }); 
 
+// register the subscription to be unloaded when the code block is unloaded
 component.registerEvent(unloadCb);
 
+// return the reactive component
 return reactive;
 ```

exampleVault/Test.md

@@ -10,7 +10,7 @@
 		"test": "jest",
 		"format": "prettier --write .",
 		"lint": "eslint --max-warnings=0 src/**",
-		"types": "tsc",
+		"types": "tsc --declaration --emitDeclarationOnly --outfile index.d.ts",
 		"docs": "node docs.js"
 	},
 	"keywords": [],
@@ -41,9 +41,11 @@
 		"typescript": "^5.1.6"
 	},
 	"dependencies": {
+		"@lemons_dev/parsinom": "^0.0.11",
 		"@popperjs/core": "^2.11.8",
+		"itertools-ts": "^1.27.0",
 		"obsidian-svelte": "^0.1.9",
-		"svelte-portal": "^2.2.0",
-		"svelte": "^4.0.1"
+		"svelte": "^4.0.1",
+		"svelte-portal": "^2.2.0"
 	}
 }

exampleVault/dv.js

@@ -1,10 +1,6 @@
 import { MarkdownPostProcessorContext, MarkdownRenderChild, Menu, setIcon, TAbstractFile, TFile } from 'obsidian';
 import JsEnginePlugin from './main';
-import { ExecutionArgument, ExecutionContext } from './ArgumentManager';
-import { MarkdownBuilder } from './api/markdown/MarkdownBuilder';
-import { MarkdownString } from './api/markdown/MarkdownString';
-import { MessageWrapper } from './messages/MessageManager';
-import MessageComponent from './messages/MessageComponent.svelte';
+import { ExecutionContext } from './ArgumentManager';
 
 import { JsExecution } from './jsEngine/JsExecution';
 import { ResultRenderer } from './ResultRenderer';

exampleVault/test.js

@@ -43,6 +43,7 @@ export class ResultRenderer {
 
 		if (content instanceof HTMLElement) {
 			this.container.append(content);
+			return;
 		}
 
 		if (content instanceof MessageWrapper) {
@@ -55,11 +56,15 @@ export class ResultRenderer {
 					showMessageSource: false,
 				},
 			});
+			return;
 		}
 
 		if (content instanceof ReactiveComponent) {
 			content.setRenderer(this);
 			content.initialRender();
+			return;
 		}
+
+		this.container.innerText = JSON.stringify(content);
 	}
 }