dirac-lang 0.1.2

package/examples/llm-recursive.di

@@ -0,0 +1,31 @@
+<!-- Recursive LLM - LLM calling Dirac calling LLM -->
+<dirac>
+  <!-- Define a subroutine that gets stock info -->
+  <subroutine name="getStockPrice">
+    <parameters>
+      <variable name="symbol" passby="value" />
+    </parameters>
+    
+    <LLM output="price" maxTokens="50">
+      What is the current approximate stock price of ${symbol}? 
+      Respond with just a number (e.g., "150.23").
+    </LLM>
+    
+    <output>${symbol}: $${price}</output>
+  </subroutine>
+  
+  <!-- LLM decides which stocks to check -->
+  <LLM output="response">
+    List 3 major tech stocks to check, one per line.
+    Format: SYMBOL only (e.g., "AAPL")
+  </LLM>
+  
+  <output>Checking stocks from LLM: ${response}&#10;&#10;</output>
+  
+  <!-- In the future, this could parse ${response} and call getStockPrice for each -->
+  <call name="getStockPrice">
+    <parameters>
+      <variable value="AAPL" />
+    </parameters>
+  </call>
+</dirac>

package/examples/llm-reflection-test.di

@@ -0,0 +1,19 @@
+<dirac>
+  <subroutine name="inventory" description="Show you the inventory" >
+   you have reachded the inventory
+  </subroutine>
+
+  <subroutine name="order" description="Places an order for an item." param-item="string:required:Item name" param-quantity="number:required:Quantity">
+    <parameters select="@item"/>
+    <parameters select="@quantity"/>
+    <output> 
+    this is my item: <variable name="item" /> 
+    and <variable name="quantity" />
+    </output>
+  </subroutine>
+
+  <llm execute="true">Show me my inventory</llm>
+  <llm execute="true">Order 2 apples</llm>
+
+  
+</dirac>

package/examples/llm-subs.di

@@ -0,0 +1,132 @@
+<dirac>
+  <!-- UI Control Services -->
+  <!-- These subroutines are exposed as natural language endpoints -->
+
+  <subroutine name="background" 
+              description="Change the background color, do not generate other tags like <changeBackground /> use precise tag"
+              param-color="string:required:Background color:red|blue|green|yellow|orange|purple|pink|white|black">
+    <parameters select="@color"/>
+              
+    <eval>
+      console.log('Changing background color to: ' + color);
+    </eval>
+  </subroutine>
+
+  <subroutine name="set-text-size"
+              description="Adjust the text size"
+              param-size="string:required:Font size:12px|14px|16px|18px|20px|24px">
+    <parameters select="@size" />
+    <eval>
+      console.log("change text size to "+size );
+      document.body.style.fontSize = '${size}';
+    </eval>
+  </subroutine>
+
+  <subroutine name="reset-styles"
+              description="Reset all styles to default">
+    <eval>
+      console.log("reset all styles back");
+      document.body.style.backgroundColor = 'white';
+      document.body.style.fontSize = '16px';
+    </eval>
+  </subroutine>
+
+  <subroutine name="text-color"
+              description="Change the text color"
+              param-color="string:required:Text color:black|white|red|blue|green">
+   <parameters select="@color" />
+    <eval>
+      console.log("change color of text to "+color);
+      document.body.style.color = '${color}';
+    </eval>
+  </subroutine>
+
+  <!-- Event Generation Examples -->
+  
+  <subroutine name="click-button"
+              description="Simulate clicking a button"
+              param-selector="string:optional:CSS selector (default: #submit-button)">
+    <eval>
+      const selector = '${selector}' || '#submit-button';
+      const element = document.querySelector(selector);
+      if (element) {
+        const clickEvent = new MouseEvent('click', {
+          bubbles: true,
+          cancelable: true,
+          view: window
+        });
+        element.dispatchEvent(clickEvent);
+      } else {
+        throw new Error('Element not found: ' + selector);
+      }
+    </eval>
+  </subroutine>
+
+  <subroutine name="type-text"
+              description="Type text into an input field"
+              param-text="string:required:Text to type"
+              param-field="string:optional:Which field:name|email">
+    <parameters select="@text" />
+    <parameters select="@field" />
+    <eval>
+      const _field = typeof field !== 'undefined' && field ? field : 'name';
+      const selector = _field === 'email' ? '#email-input' : '#name-input';
+      const input = document.querySelector(selector);
+      if (input) {
+        input.value = text;
+        input.dispatchEvent(new Event('input', { bubbles: true }));
+        input.dispatchEvent(new Event('change', { bubbles: true }));
+      } else {
+        throw new Error('Input not found: ' + selector);
+      }
+    </eval>
+  </subroutine>
+
+  <subroutine name="check-terms"
+              description="Check or uncheck the terms checkbox"
+              param-checked="string:optional:Check state:true|false">
+    <eval>
+      const shouldCheck = '${checked}' !== 'false';
+      const checkbox = document.querySelector('#terms-checkbox');
+      if (checkbox) {
+        checkbox.checked = shouldCheck;
+        checkbox.dispatchEvent(new Event('change', { bubbles: true }));
+      } else {
+        throw new Error('Checkbox not found');
+      }
+    </eval>
+  </subroutine>
+
+  <subroutine name="clear-input"
+              description="Clear an input field"
+              param-field="string:optional:Which field:name|email">
+    <eval>
+      const field = '${field}' || 'name';
+      const selector = field === 'email' ? '#email-input' : '#name-input';
+      const input = document.querySelector(selector);
+      if (input) {
+        input.value = '';
+        input.dispatchEvent(new Event('input', { bubbles: true }));
+        input.dispatchEvent(new Event('change', { bubbles: true }));
+      } else {
+        throw new Error('Input not found: ' + selector);
+      }
+    </eval>
+  </subroutine>
+
+<!--
+  <subroutine name="modify-file" 
+   description="modify a file based on pattern and replacement field "
+   param-filename="string|required"
+   param-pattern="string|required"
+   param-replace="string|required"
+  >
+   <parameters select="@filename" />
+   <parameters select="@pattern" />
+   <parameters select="@replace" />
+   <system>
+     sed -e 's/${pattern}/${replace}/g' ${filename} 
+   </system>
+  </subroutine>
+  -->
+</dirac>

package/examples/llm-use-subs.di

@@ -0,0 +1,6 @@
+<dirac>
+  <import src="llm-subs.di" />
+  <llm execute="true">set the background color to red</llm>
+
+  
+</dirac>

package/examples/loop.di

@@ -0,0 +1,12 @@
+<!-- Loop and conditional test -->
+<dirac>
+  <defvar name="result" value="" />
+  
+  <loop count="5" var="i">
+    <eval name="isEven" expr="i % 2 === 0" />
+    
+    <if test="${isEven} == true">
+      <output>${i} is even&#10;</output>
+    </if>
+  </loop>
+</dirac>

package/examples/math-test.di

@@ -0,0 +1,22 @@
+#!/usr/bin/env dirac
+<dirac>
+  <import src="./lib/math.di" />
+  
+  <output>Math Library Test&#10;&#10;</output>
+  
+  <defvar name="x" value="8" />
+  <output>Square of ${x}: </output>
+  <call name="SQUARE" />
+  <output>&#10;</output>
+  
+  <defvar name="a" value="15" />
+  <defvar name="b" value="25" />
+  <output>${a} + ${b} = </output>
+  <call name="ADD" />
+  <output>&#10;</output>
+  
+  <defvar name="num" value="6" />
+  <output>Factorial of ${num}: </output>
+  <call name="FACTORIAL" />
+  <output>&#10;</output>
+</dirac>

package/examples/mongodb-count-events.di

@@ -0,0 +1,8 @@
+
+
+<dirc >
+<mongodb database="betting" collection="events" action="find">
+  { }
+</mongodb>
+
+</dirac>

package/examples/mongodb-import-demo.di

@@ -0,0 +1,25 @@
+#!/usr/bin/env dirac
+<!-- Demo: Using MongoDB extension library -->
+<dirac>
+
+ 
+  <subroutine name="MONGODB">
+    <parameters select="@database" />
+    <parameters select="@collection" />
+    <defvar name="body"><parameters select="*"/></defvar> 
+    <!-- <defvar name="body">some body</defvar> -->
+    
+    <output>database is: <variable name="database" />&#10;</output>
+    <output>collection is: <variable name="collection" />&#10;</output>
+    <output>query is: <variable name="body" />&#10;</output> 
+    <output>from dirac&#10;</output>
+
+
+  </subroutine>
+
+  
+<MONGODB database="betting" collection="events" action="find">
+ hi, this is a test
+</MONGODB>
+
+</dirac>

package/examples/mongodb-simple-test.di

@@ -0,0 +1,18 @@
+#!/usr/bin/env dirac
+<!-- Simple MongoDB extension test -->
+<dirac>
+
+
+  <!-- Import the MongoDB extension library -->
+  <import src="./lib/mongodb.di" />
+
+
+  <MONGODB database="betting" collection="events" action="find">{ "type.name": "Pass" }</MONGODB>
+
+<!--
+  <output>Testing MongoDB count:&#10;</output>
+ 
+  <MONGODB database="betting" collection="events" action="count">{ "type.name": "Pass" }</MONGODB>
+  -->
+
+</dirac>

package/examples/nl-agent.di

@@ -0,0 +1,47 @@
+<!-- Advanced Agent - Natural language to operations -->
+<dirac>
+  <output>Interactive Agent Example&#10;&#10;</output>
+  
+  <!-- Task 1: File operations -->
+  <defvar name="userRequest" value="count how many .di files are in examples directory" />
+  
+  <output>Request: ${userRequest}&#10;</output>
+  <LLM output="code1" maxTokens="300">
+    Generate Dirac XML to: ${userRequest}
+    
+    Use these tags ONLY:
+    1. &lt;eval name="varname"&gt;return javascriptExpression;&lt;/eval&gt;
+    2. &lt;output&gt;text with ${varname}&lt;/output&gt;
+    
+    Example:
+    &lt;dirac&gt;
+      &lt;eval name="result"&gt;return fs.readdirSync('examples').filter(f =&gt; f.endsWith('.di')).length;&lt;/eval&gt;
+      &lt;output&gt;Count: ${result}&lt;/output&gt;
+    &lt;/dirac&gt;
+    
+    Return only XML, no markdown or explanations.
+  </LLM>
+  
+  <output>Executing...&#10;</output>
+  <execute source="code1" />
+  <output>&#10;&#10;</output>
+  
+  <!-- Task 2: Data processing -->
+  <assign name="userRequest" value="create a JSON file with current date and time" />
+  
+  <output>Request: ${userRequest}&#10;</output>
+  <LLM output="code2" maxTokens="300">
+    Generate Dirac XML to: ${userRequest}
+    
+    Available:
+    - &lt;eval name="var"&gt;return jsExpression&lt;/eval&gt; (MUST use 'return', fs and path available, can use Date)
+    - &lt;output&gt;text ${variable}&lt;/output&gt;
+    
+    IMPORTANT: Every eval MUST have 'return' statement.
+    Return only &lt;dirac&gt; XML, no markdown. Name the file timestamp.json.
+  </LLM>
+  
+  <output>Executing...&#10;</output>
+  <execute source="code2" />
+  <output>&#10;</output>
+</dirac>

package/examples/parameters-demo.di

@@ -0,0 +1,68 @@
+#!/usr/bin/env dirac
+<dirac>
+  <!-- 
+    Parameters Tag Example
+    
+    The <parameters> tag allows subroutines to access their caller's
+    children and attributes, enabling functional-style parameter passing.
+    
+    select="*"      - Execute all child elements of caller
+    select="@attr"  - Emit specific attribute value
+    select="@*"     - Emit all attributes as name="value" pairs
+  -->
+
+  <!-- Example 1: Functional wrapper with child content -->
+  <subroutine name="BOLD">
+    <output>&lt;b&gt;</output>
+    <parameters select="*"/>
+    <output>&lt;/b&gt;</output>
+  </subroutine>
+
+  <output>Example 1: </output>
+  <BOLD>
+    <output>Hello World</output>
+  </BOLD>
+  <output>&#10;</output>
+
+  <!-- Example 2: Attribute passthrough -->
+  <subroutine name="ATTR_DEMO">
+    <output>a=</output>
+    <parameters select="@a"/>
+    <output>, b=</output>
+    <parameters select="@b"/>
+  </subroutine>
+
+  <output>Example 2: </output>
+  <ATTR_DEMO a="3" b="4"/>
+  <output>&#10;</output>
+
+  <!-- Example 3: Inspector showing all attributes -->
+  <subroutine name="INSPECT">
+    <output>Element attributes: [</output>
+    <parameters select="@*"/>
+    <output>]&#10;</output>
+  </subroutine>
+
+  <output>Example 3:&#10;</output>
+  <INSPECT id="widget-1" type="button" enabled="true"/>
+
+  <!-- Example 4: List formatter -->
+  <subroutine name="UL">
+    <output>&lt;ul&gt;&#10;</output>
+    <parameters select="*"/>
+    <output>&lt;/ul&gt;&#10;</output>
+  </subroutine>
+
+  <subroutine name="LI">
+    <output>  &lt;li&gt;</output>
+    <parameters select="*"/>
+    <output>&lt;/li&gt;&#10;</output>
+  </subroutine>
+
+  <output>Example 4:&#10;</output>
+  <UL>
+    <LI><output>First item</output></LI>
+    <LI><output>Second item</output></LI>
+    <LI><output>Third item</output></LI>
+  </UL>
+</dirac>

package/examples/params-test.di

@@ -0,0 +1,10 @@
+<dirac>
+  <subroutine name="greet">
+    <parameters select="@name"/>
+    <output>Hello, <variable name="name"/>!</output>
+  </subroutine>
+  
+  <greet name="Alice"/>
+  <output>&#10;</output>
+  <greet name="Bob"/>
+</dirac>

package/examples/recipe-chain.di

@@ -0,0 +1,38 @@
+<!-- Recipe Generator - Chained LLM calls -->
+<dirac>
+  <defvar name="ingredients" value="chicken, rice, tomatoes, garlic" />
+  
+  <output>Available ingredients: ${ingredients}&#10;&#10;</output>
+  
+  <!-- Step 1: Generate a dish name -->
+  <output>Step 1: Coming up with a dish...&#10;</output>
+  <LLM output="dishName" maxTokens="50">
+    Given these ingredients: ${ingredients}
+    Suggest ONE dish name (just the name, nothing else).
+  </LLM>
+  <output>Dish: ${dishName}&#10;&#10;</output>
+  
+  <!-- Step 2: Create the recipe using the dish name -->
+  <output>Step 2: Creating recipe for ${dishName}...&#10;</output>
+  <LLM output="recipe" maxTokens="400">
+    Create a simple recipe for "${dishName}" using: ${ingredients}
+    
+    Format:
+    Ingredients:
+    - list items
+    
+    Instructions:
+    1. numbered steps
+    
+    Keep it brief and practical.
+  </LLM>
+  <output>&#10;${recipe}&#10;&#10;</output>
+  
+  <!-- Step 3: Estimate cooking time -->
+  <output>Step 3: Estimating time...&#10;</output>
+  <LLM output="cookTime" maxTokens="50" context="recipe">
+    Based on this recipe, what's the total cooking time?
+    Answer with just a number and unit (e.g., "45 minutes").
+  </LLM>
+  <output>Total time: ${cookTime}&#10;</output>
+</dirac>

package/examples/recursive-llm.di

@@ -0,0 +1,44 @@
+<!-- Recursive LLM-Dirac Interleaving (LISP Style) -->
+<dirac>
+  <output>Recursive Execution Demo&#10;&#10;</output>
+  
+  <!-- Define subroutines that can be called by LLM -->
+  <subroutine name="GET_FILE_COUNT">
+    <eval name="count">
+      return fs.readdirSync('examples').filter(f => f.endsWith('.di')).length;
+    </eval>
+    <output>File count: ${count}&#10;</output>
+  </subroutine>
+  
+  <subroutine name="GET_FILE_NAMES">
+    <eval name="names">
+      return fs.readdirSync('examples')
+        .filter(f => f.endsWith('.di'))
+        .slice(0, 3)
+        .join(', ');
+    </eval>
+    <output>Sample files: ${names}&#10;</output>
+  </subroutine>
+  
+  <subroutine name="ANALYZE_DEEPER">
+    <output>Deep analysis requested...&#10;</output>
+    <!-- This subroutine itself calls an LLM! Recursion! -->
+    <LLM execute="true" maxTokens="80">
+      Return XML: &lt;dirac&gt;&lt;output&gt;Analysis complete!&#10;&lt;/output&gt;&lt;/dirac&gt;
+    </LLM>
+  </subroutine>
+  
+  <!-- Level 1: User calls LLM -->
+  <output>Level 1: Asking LLM to analyze...&#10;</output>
+  <LLM execute="true" maxTokens="150">
+    Return ONLY XML calling these subroutines:
+    &lt;dirac&gt;
+      &lt;output&gt;Starting analysis...&#10;&lt;/output&gt;
+      &lt;GET_FILE_COUNT /&gt;
+      &lt;GET_FILE_NAMES /&gt;
+      &lt;ANALYZE_DEEPER /&gt;
+    &lt;/dirac&gt;
+  </LLM>
+  
+  <output>&#10;All levels complete!&#10;</output>
+</dirac>

package/examples/sample-library/README.md

@@ -0,0 +1,152 @@
+# dirac-string
+
+String manipulation library for Dirac.
+
+![npm version](https://img.shields.io/npm/v/dirac-string)
+![license](https://img.shields.io/npm/l/dirac-string)
+
+## Installation
+
+```bash
+npm install dirac-string
+```
+
+## Usage
+
+```xml
+<dirac>
+  <import src="./node_modules/dirac-string/lib/index.di"/>
+  
+  <UPPERCASE text="hello world"/>
+  <!-- Outputs: HELLO WORLD -->
+  
+  <LOWERCASE text="HELLO WORLD"/>
+  <!-- Outputs: hello world -->
+  
+  <SUBSTRING text="Hello World" start="0" end="5"/>
+  <!-- Outputs: Hello -->
+</dirac>
+```
+
+## API Reference
+
+### UPPERCASE
+Convert text to uppercase.
+
+**Attributes:**
+- `text` (string, required) - Text to convert
+
+**Example:**
+```xml
+<UPPERCASE text="hello"/>
+<!-- Output: HELLO -->
+```
+
+### LOWERCASE  
+Convert text to lowercase.
+
+**Attributes:**
+- `text` (string, required) - Text to convert
+
+**Example:**
+```xml
+<LOWERCASE text="WORLD"/>
+<!-- Output: world -->
+```
+
+### TRIM
+Remove leading and trailing whitespace.
+
+**Attributes:**
+- `text` (string, required) - Text to trim
+
+**Example:**
+```xml
+<TRIM text="  hello  "/>
+<!-- Output: hello -->
+```
+
+### SUBSTRING
+Extract a substring.
+
+**Attributes:**
+- `text` (string, required) - Source text
+- `start` (number, required) - Start index (0-based)
+- `end` (number, optional) - End index (exclusive)
+
+**Example:**
+```xml
+<SUBSTRING text="Hello World" start="6" end="11"/>
+<!-- Output: World -->
+```
+
+### REPLACE
+Replace all occurrences of a pattern.
+
+**Attributes:**
+- `text` (string, required) - Source text
+- `find` (string, required) - Pattern to find (regex)
+- `replace` (string, required) - Replacement text
+
+**Example:**
+```xml
+<REPLACE text="Hello World" find="World" replace="Dirac"/>
+<!-- Output: Hello Dirac -->
+```
+
+### SPLIT
+Split text into array.
+
+**Attributes:**
+- `text` (string, required) - Text to split
+- `delimiter` (string, optional) - Delimiter (default: ",")
+
+**Example:**
+```xml
+<SPLIT text="a,b,c" delimiter=","/>
+<!-- Output: ["a","b","c"] -->
+```
+
+### LENGTH
+Get string length.
+
+**Attributes:**
+- `text` (string, required) - Text to measure
+
+**Example:**
+```xml
+<LENGTH text="Hello"/>
+<!-- Output: 5 -->
+```
+
+## Development
+
+```bash
+# Clone repository
+git clone https://github.com/dirac-lang/dirac-string
+cd dirac-string
+
+# Run examples
+dirac examples/demo.di
+
+# Run tests
+npm test
+```
+
+## Contributing
+
+Contributions welcome! Please:
+1. Fork the repository
+2. Create a feature branch
+3. Add tests for new functionality
+4. Submit a pull request
+
+## License
+
+MIT © Dirac Community
+
+## Links
+
+- [Dirac Language](https://github.com/wangzhi63/dirac)
+- [Report Issues](https://github.com/dirac-lang/dirac-string/issues)
+- [All Dirac Libraries](https://github.com/topics/dirac-library)

package/examples/sample-library/examples/demo.di

@@ -0,0 +1,34 @@
+#!/usr/bin/env dirac
+<dirac>
+  <import src="../lib/index.di"/>
+
+  <output>String Library Demo&#10;&#10;</output>
+
+  <output>1. STR_UPPERCASE: </output>
+  <STR_UPPERCASE text="hello world"/>
+  <output>&#10;</output>
+
+  <output>2. STR_LOWERCASE: </output>
+  <STR_LOWERCASE text="HELLO WORLD"/>
+  <output>&#10;</output>
+
+  <output>3. STR_TRIM: </output>
+  <STR_TRIM text="  spaces  "/>
+  <output>&#10;</output>
+
+  <output>4. STR_SUBSTRING (0,5): </output>
+  <STR_SUBSTRING text="Hello World" start="0" end="5"/>
+  <output>&#10;</output>
+
+  <output>5. STR_REPLACE: </output>
+  <STR_REPLACE text="Hello World" find="World" replace="Dirac"/>
+  <output>&#10;</output>
+
+  <output>6. STR_SPLIT: </output>
+  <STR_SPLIT text="apple,banana,cherry" delimiter=","/>
+  <output>&#10;</output>
+
+  <output>7. STR_LENGTH: </output>
+  <STR_LENGTH text="Hello"/>
+  <output>&#10;</output>
+</dirac>