finished new API

Author: mProjectsCode

exampleVault/Meta Bind JS.md

@@ -2,56 +2,19 @@
 select: c
 ---
 
-test
-```meta-bind-js
-const declaration = mb.createDeclaration(
-	'select',
-	[
-		{type: 'option', value: 'a'},
-		{type: 'option', value: 'c'},
-	]
-);
+```js-engine
+const mb = engine.getPlugin('obsidian-meta-bind-plugin').api;
 
-mb.bindDeclaration(declaration, 'select');
+const options = ['a', 'b', 'c'];
 
-const inputField = mb.createInputField(declaration, undefined, 'block');
+let declaration = mb.inputField.createInputFieldDeclaration();
+declaration = mb.inputField.setType(declaration, 'select');
+declaration = mb.inputField.setBindTargetMetadataField(declaration, 'select');
 
-inputField.readSignal.registerListener({callback: (value) => console.log(`test ${value}`)})
+for (const option of options) {
+	declaration = mb.inputField.addArgument(declaration, {name: 'option', value: option});
+}
 
-ctx.addChild(inputField);
-```
+mb.createInputField(declaration, 'block', context.file.path, container, component);
 
-```meta-bind-js
-const declaration = mb.createDeclaration(
-	'select',
-	[
-		{type: 'option', value: 'd'},
-		{type: 'option', value: 'e'},
-	]
-);
-
-mb.bindDeclaration(declaration, 'select');
-
-const inputField = mb.createInputField(declaration, undefined, 'block');
-
-ctx.addChild(inputField);
-```
-
-```js
-const declaration = mb.createDeclaration(
-	'select',
-	[
-		{type: 'option', value: 'a'},
-		{type: 'option', value: 'c'},
-	],
-	'select'
-);
-
-0000
-
-const inputField = mb.createInputField(declaration, undefined, 'block');
-
-ctx.addChild(inputField);
-```
-
-test
+```

exampleVault/View Fields/View Field.md

@@ -1,7 +1,7 @@
 ---
 number1: 11
 number2: 20
-unit: km
+unit: m
 ---
 
 `INPUT[number:number1]`

src/api/API.ts

@@ -7,6 +7,7 @@ import { JsViewFieldMDRC } from '../renderChildren/JsViewFieldMDRC';
 import MetaBindPlugin from '../main';
 import { NewInputFieldDeclarationParser, UnvalidatedInputFieldDeclaration } from '../parsers/newInputFieldParser/InputFieldParser';
 import { Component, MarkdownPostProcessorContext } from 'obsidian';
+import { InputFieldAPI } from './InputFieldAPI';
 
 export class API {
 	public plugin: MetaBindPlugin;
@@ -15,13 +16,17 @@ export class API {
 	public viewFieldParser: ViewFieldDeclarationParser;
 	public bindTargetParser: BindTargetParser;
 
+	public readonly inputField: InputFieldAPI;
+
 	constructor(plugin: MetaBindPlugin) {
 		this.plugin = plugin;
 
 		// this.inputFieldParser = new InputFieldDeclarationParser();
 		this.newInputFieldParser = new NewInputFieldDeclarationParser(this.plugin);
 		this.viewFieldParser = new ViewFieldDeclarationParser();
 		this.bindTargetParser = new BindTargetParser(this.plugin);
+
+		this.inputField = new InputFieldAPI(this);
 	}
 
 	public createInputField(

src/api/InputFieldAPI.ts

@@ -1,5 +1,5 @@
 import { InputFieldArgumentType, InputFieldType } from '../parsers/InputFieldDeclarationParser';
-import { UnvalidatedInputFieldDeclaration } from '../parsers/newInputFieldParser/InputFieldParser';
+import { StructureParserResult, UnvalidatedInputFieldDeclaration } from '../parsers/newInputFieldParser/InputFieldParser';
 import { ErrorCollection } from '../utils/errors/ErrorCollection';
 import { API } from './API';
 import { useSyncExternalStore } from 'preact/compat';
@@ -89,4 +89,25 @@ export class InputFieldAPI {
 
 		return unvalidatedDeclaration;
 	}
+
+	public getTemplate(templateName: string): Readonly<UnvalidatedInputFieldDeclaration> | undefined {
+		return this.api.newInputFieldParser.getTemplate(templateName);
+	}
+
+	public merge(unvalidatedDeclaration: UnvalidatedInputFieldDeclaration, override: UnvalidatedInputFieldDeclaration): UnvalidatedInputFieldDeclaration {
+		return {
+			fullDeclaration: '',
+			inputFieldType: override.inputFieldType !== undefined ? override.inputFieldType : unvalidatedDeclaration.inputFieldType,
+			bindTargetFile: override.bindTargetFile !== undefined ? override.bindTargetFile : unvalidatedDeclaration.bindTargetFile,
+			bindTargetPath: override.bindTargetPath !== undefined ? override.bindTargetPath : unvalidatedDeclaration.bindTargetPath,
+			arguments: override.arguments.concat(unvalidatedDeclaration.arguments).reduce((arr, currentValue) => {
+				// filter out duplicates
+				if (arr.find(x => x.name === currentValue.name) === undefined) {
+					arr.push(currentValue);
+				}
+				return arr;
+			}, [] as { name: StructureParserResult; value?: StructureParserResult | undefined }[]),
+			errorCollection: unvalidatedDeclaration.errorCollection.merge(override.errorCollection),
+		};
+	}
 }

src/parsers/newInputFieldParser/InputFieldParser.ts

@@ -19,6 +19,7 @@ import { InputFieldParsingTreeParser } from './InputFieldParsingTreeParser';
 import { Abstract_PT_Node, ParsingTree, PT_Closure, PT_Element, PT_Element_Type, PT_Literal } from './ParsingTree';
 import { InputFieldToken, InputFieldTokenizer, InputFieldTokenType } from './InputFieldTokenizer';
 import { InputFieldTemplate } from '../../settings/Settings';
+import { deepFreeze } from '../../utils/Utils';
 
 export interface UnvalidatedInputFieldDeclaration {
 	fullDeclaration: string;
@@ -544,8 +545,8 @@ export class InputFieldDeclarationValidator {
 }
 
 export interface InputFieldDeclarationTemplate {
-	name: string;
-	template: UnvalidatedInputFieldDeclaration;
+	readonly name: string;
+	readonly template: Readonly<UnvalidatedInputFieldDeclaration>;
 }
 
 export class NewInputFieldDeclarationParser {
@@ -649,16 +650,18 @@ export class NewInputFieldDeclarationParser {
 
 			errorCollection.merge(templateDeclaration.errorCollection);
 
-			this.templates.push({
+			const temp: InputFieldDeclarationTemplate = {
 				name: template.name,
 				template: templateDeclaration,
-			});
+			};
+
+			this.templates.push(deepFreeze(temp));
 		}
 
 		return errorCollection;
 	}
 
-	public getTemplate(templateName: string): UnvalidatedInputFieldDeclaration | undefined {
+	public getTemplate(templateName: string): Readonly<UnvalidatedInputFieldDeclaration> | undefined {
 		return this.templates.find(x => x.name === templateName)?.template;
 	}
 }

src/utils/Utils.ts

@@ -254,7 +254,7 @@ export function deepEquals(any1: unknown, any2: unknown): boolean {
 	return any1 === any2;
 }
 
-export function deepFreeze<T extends object>(object: T): T {
+export function deepFreeze<T extends object>(object: T): Readonly<T> {
 	// Retrieve the property names defined on object
 	const propNames: (string | symbol)[] = Reflect.ownKeys(object);