Merge branch 'main' into add-versions-fetch

Author: theletterf

README.md

@@ -62,6 +62,7 @@ Example: `{subs}`wget elasticsearch-{{version}}.tar.gz``
 - `{image}` - Images with alt text and sizing options
 - `{carousel}` - Image carousels (supports `:max-height:`)
 - `{diagram}` - Various diagram types (mermaid, d2, graphviz, plantuml, etc.)
+- `{math}` - Mathematical expressions using LaTeX syntax (supports `:label:` for cross-referencing)
 
 ### Content inclusion
 - `{include}` - Include content from other files

package.json

@@ -16,8 +16,7 @@
   ],
   "icon": "images/icon.png",
   "activationEvents": [
-    "onLanguage:markdown",
-    "onStartupFinished"
+    "onLanguage:markdown"
   ],
   "main": "./out/extension.js",
   "browser": "./out/extension-web.js",

src/directives.ts

@@ -145,6 +145,13 @@ export const DIRECTIVES: readonly DirectiveDefinition[] = [
         template: ':::{csv-include} _snippets/sample-data.csv\n:caption: Sample user data from the database\n:::',
         description: 'Include and render CSV files as formatted tables.'
     },
+    {
+        name: 'math',
+        hasArgument: false,
+        parameters: ['label'],
+        template: ':::{math}\n:label: equation-label\nE = mc^2\n:::',
+        description: 'Render mathematical expressions using LaTeX syntax. Mathematical expressions are rendered client-side using KaTeX for fast, accurate display.'
+    },
 ];
 
 export const PARAMETER_VALUES: { [key: string]: string[] } = {

src/extension.ts

@@ -355,6 +355,17 @@ export function activate(context: vscode.ExtensionContext): void {
 function applyColorCustomizations(): void {
     const config = vscode.workspace.getConfiguration('editor');
     const currentCustomizations = config.get('tokenColorCustomizations') as Record<string, unknown> || {};
+    const existingRules = (currentCustomizations.textMateRules as Array<{ scope?: string }>) || [];
+
+    // Check if our rules are already applied by looking for a known elastic scope
+    const elasticRulesAlreadyApplied = existingRules.some(
+        rule => rule.scope && rule.scope.includes('.elastic')
+    );
+
+    if (elasticRulesAlreadyApplied) {
+        // Rules already exist, skip the expensive settings write
+        return;
+    }
 
     // Define our custom color rules
     const elasticRules = [
@@ -435,11 +446,9 @@ function applyColorCustomizations(): void {
         }
     ];
 
-    // Merge with existing rules
-    const existingRules = (currentCustomizations.textMateRules as unknown[]) || [];
+    // Merge with existing rules and apply (only on first activation)
     const newRules = [...existingRules, ...elasticRules];
 
-    // Apply the customizations
     config.update('tokenColorCustomizations', {
         ...currentCustomizations,
         textMateRules: newRules

src/products.ts

@@ -18,6 +18,7 @@
  */
 
 export const PRODUCTS: Record<string, string> = {
+  'agent-builder': 'Elastic Agent Builder',
   'apm': 'APM',
   'apm-agent': 'APM Agent',
   'apm-agent-dotnet': 'APM .NET Agent',