update stuff

Author: mProjectsCode

astro.config.mjs

@@ -27,19 +27,29 @@ export default defineConfig({
 					items: [
 						// Each item here is one entry in the navigation menu.
 						{ label: 'Installation', link: '/guides/installation/' },
-						{ label: 'Input Fields', link: '/guides/inputfields/' },
-						{ label: 'Input Field Templates', link: '/guides/templates/' },
-						{ label: 'View Fields', link: '/guides/viewfields/' },
-						{ label: 'Buttons', link: '/guides/buttons/' },
-						{ label: 'Meta Bind Embeds', link: '/guides/metabindembed/' },
-						{ label: 'Bind Targets', link: '/guides/bindtargets/' },
-
 						{ label: 'Examples', link: '/guides/examples/' },
-						{ label: 'Advanced Use-Cases', link: '/guides/advancedusecases/' },
-						{ label: 'API', link: '/guides/api/' },
-
 						{ label: 'Styling and CSS', link: '/guides/stylingandcss/' },
 						{ label: 'Obsidian Publish', link: '/guides/obsidianpublish/' },
+
+						{ 
+							label: 'Features and Concepts',
+							items: [
+								{ label: 'Input Fields', link: '/guides/inputfields/' },
+								{ label: 'Input Field Templates', link: '/guides/templates/' },
+								{ label: 'View Fields', link: '/guides/viewfields/' },
+								{ label: 'Buttons', link: '/guides/buttons/' },
+								{ label: 'Meta Bind Embeds', link: '/guides/metabindembed/' },
+								{ label: 'Bind Targets', link: '/guides/bindtargets/' },
+							]
+						},
+
+						{
+							label: 'Advanced',
+							items: [
+								{ label: 'API', link: '/guides/api/' },
+								{ label: 'Advanced Use-Cases', link: '/guides/advancedusecases/' },
+							]
+						}
 					],
 				},
 				{
@@ -95,6 +105,20 @@ export default defineConfig({
 					},
 				}),
 				starlightSiteGraph({
+					// graphConfig: {
+					// 	depth: 5,
+					// 	visibilityRules: [
+					// 		'api/**'
+					// 	]
+					// },
+					// trackVisitedPages: false,
+					// storageLocation: 'none',
+					// sitemapConfig: {
+					// 	contentRoot: './src/content/docs',
+					// 	pageInclusionRules: [
+					// 		'**/api/**',
+					// 	]
+					// },
 					graphConfig: {
 						depth: 5,
 						trackVisitedPages: false,

bun.lockb

@@ -11,15 +11,16 @@
 		"format": "prettier --plugin prettier-plugin-astro --plugin prettier-plugin-svelte --write ."
 	},
 	"dependencies": {
-		"@astrojs/starlight": "0.26.1",
-		"astro": "4.14.2",
-		"starlight-links-validator": "^0.9.1",
+		"@astrojs/starlight": "0.27.1",
+		"astro": "4.15.4",
+		"pixi-stats": "^1.3.10",
+		"starlight-links-validator": "^0.12.0",
 		"starlight-site-graph": "0.0.13",
-		"starlight-typedoc": "^0.14.0",
-		"typedoc": "^0.26.6",
-		"typedoc-plugin-markdown": "^4.2.5",
-		"typedoc-plugin-mdn-links": "^3.2.9",
-		"typescript": "^5.5.4"
+		"starlight-typedoc": "^0.16.0",
+		"typedoc": "^0.26.7",
+		"typedoc-plugin-markdown": "^4.2.7",
+		"typedoc-plugin-mdn-links": "^3.2.12",
+		"typescript": "^5.6.2"
 	},
 	"devDependencies": {
 		"prettier": "^3.3.3",

package.json

@@ -0,0 +1 @@
+{}

public/sitegraph/sitemap.json

@@ -29,7 +29,7 @@ if (!mb) {
 
 // Now we can use the API!
 
-````
+```
   </TabItem>
   <TabItem label="Plain JavaScript">
 ```js
@@ -44,19 +44,28 @@ if (!mb) {
 }
 
 // Now we can use the API!
-````
+```
 
   </TabItem>
 </Tabs>
 
 :::caution
-Do not destructure the API object like this. This will lead to errors, as the class method looses it's reference to itself via `this`.
+Do not try to use API methods as standalone functions. This will lead to errors, as the class method looses it's reference to itself via `this`.
 
 ```js
+// DON'T DO THIS
 const { someAPIMethod } = app.plugins.getPlugin('obsidian-meta-bind-plugin')?.api;
+someAPIMethod(); // will most likely error
+// OR
+const someAPIMethod = app.plugins.getPlugin('obsidian-meta-bind-plugin')?.api.someAPIMethod;
+someAPIMethod(); // will most likely error
+
+// DO THIS
+const mb = app.plugins.getPlugin('obsidian-meta-bind-plugin')?.api;
+mb.someAPIMethod(); // works
 ```
 
-This is a general issue with object destructuring and JavaScript classes.
+This is a general issue with JavaScript classes.
 
 ```js
 class Foo {
@@ -75,6 +84,10 @@ foo.baz(); // will log 5
 const { baz } = foo;
 // `baz` became a standalone function and thus `this` is now `undefined`.
 baz(); // error: can't access property `bar`, `this` is `undefined`
+
+const baz2 = foo.baz;
+// `baz2` became a standalone function and thus `this` is now `undefined`.
+baz2(); // error: can't access property `bar`, `this` is `undefined`
 ```
 
 :::

src/content/docs/guides/api.mdx

@@ -62,8 +62,8 @@ To add options to the dropdown select we will use the `option(name)` argument.
 
 ```meta-bind
 INPUT[inlineSelect(
-    option(trash),
     option(bad),
+    option(meh),
     option(ok),
     option(good),
     option(great)
@@ -76,8 +76,8 @@ If we want numeric values to represent the rating in our frontmatter, we can pas
 
 ```meta-bind
 INPUT[inlineSelect(
-    option(1, trash),
-    option(2, bad),
+    option(1, bad),
+    option(2, meh),
     option(3, ok),
     option(4, good),
     option(5, great)
@@ -88,7 +88,7 @@ We can also include commas in our value names by surrounding them with quotes.
 
 ```meta-bind
 INPUT[inlineSelect(
-    option(1, 'trash, do not watch'),
+    option(1, 'if you value your time, do not watch'),
     ...
 ):rating]
 ```
@@ -97,7 +97,7 @@ Such strings also support escaping using a backslash. To have a single backslash
 
 ```meta-bind
 INPUT[inlineSelect(
-    option(1, 'trash, don\'t watch'),
+    option(1, 'if you value your time, don\'t watch'),
     ...
 ):rating]
 ```

src/content/docs/guides/inputFields.md

@@ -20,7 +20,12 @@ Canary build might contain new features that are **not yet ready** and therefore
 These feature previews may introduce **breaking changes without warning**.
 There is no changelog for canary builds.
 
-You can install canary builds via [BRAT](https://github.com/TfTHacker/obsidian42-brat).
-
 If you don't know if you are using a canary build, you can look at the version number in the Obsidian settings.
 Canary builds have a version number ending in `-canary` plus a timestamp, e.g. `0.9.0-canary.20231129T131457`.
+
+Canary builds can be installed using BRAT by following the steps outlined below.
+
+1. Install and enable the BRAT plugin
+2. Run the BRAT: Plugins: Add a beta plugin for testing command
+3. Enter https://github.com/mProjectsCode/obsidian-meta-bind-plugin into the text field
+4. Click on Add Plugin