dirac-lang 0.1.23 → 0.1.25

package/examples/nl-agent.di

@@ -1,47 +0,0 @@
-<!-- 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

@@ -1,68 +0,0 @@
-#!/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-meta-test.di

@@ -1,17 +0,0 @@
-<dirac>
-  <subroutine name="greet">
-    <parameters select="@name"/>
-    <output>Hello, <variable name="name"/>!</output>
-  </subroutine>
-  
-  <subroutine name="greetmeta" param-name="string:required:name of the person" >
-    <output>From Meta: Hello, <variable name="name" /></output>
-  </subroutine>
-  <greet name="Alice"/>
-  <output>&#10;</output>
-  <greet name="Bob"/>
-
-  <output>&#10;</output>
-  <greetmeta name="Zhi" />
-  
-</dirac>

package/examples/params-test.di

@@ -1,10 +0,0 @@
-<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

@@ -1,38 +0,0 @@
-<!-- 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

@@ -1,44 +0,0 @@
-<!-- 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

@@ -1,152 +0,0 @@
-# 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

@@ -1,34 +0,0 @@
-#!/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>

package/examples/sample-library/lib/index.di

@@ -1,65 +0,0 @@
-<dirac>
-
-<subroutine name="STR_UPPERCASE">
-  <eval>
-    const caller = getParams();
-    const text = caller.attributes.text || '';
-    console.log(text.toUpperCase());
-  </eval>
-</subroutine>
-
-<subroutine name="STR_LOWERCASE">
-  <eval>
-    const caller = getParams();
-    const text = caller.attributes.text || '';
-    console.log(text.toLowerCase());
-  </eval>
-</subroutine>
-
-<subroutine name="STR_TRIM">
-  <eval>
-    const caller = getParams();
-    const text = caller.attributes.text || '';
-    console.log(text.trim());
-  </eval>
-</subroutine>
-
-<subroutine name="STR_SUBSTRING">
-  <eval>
-    const caller = getParams();
-    const text = caller.attributes.text || '';
-    const start = parseInt(caller.attributes.start || 0);
-    const end = caller.attributes.end ? parseInt(caller.attributes.end) : undefined;
-    console.log(text.substring(start, end));
-  </eval>
-</subroutine>
-
-<subroutine name="STR_REPLACE">
-  <eval>
-    const caller = getParams();
-    const text = caller.attributes.text || '';
-    const find = caller.attributes.find || '';
-    const replace = caller.attributes.replace || '';
-    console.log(text.replace(new RegExp(find, 'g'), replace));
-  </eval>
-</subroutine>
-
-<subroutine name="STR_SPLIT">
-  <eval>
-    const caller = getParams();
-    const text = caller.attributes.text || '';
-    const delimiter = caller.attributes.delimiter || ',';
-    const parts = text.split(delimiter);
-    console.log(JSON.stringify(parts));
-  </eval>
-</subroutine>
-
-<subroutine name="STR_LENGTH">
-  <eval>
-    const caller = getParams();
-    const text = caller.attributes.text || '';
-    console.log(text.length);
-  </eval>
-</subroutine>
-
-</dirac>

package/examples/sample-library/package.json

@@ -1,31 +0,0 @@
-{
-  "name": "dirac-string",
-  "version": "1.0.0",
-  "description": "String manipulation library for Dirac",
-  "main": "lib/index.di",
-  "scripts": {
-    "test": "dirac tests/test.di"
-  },
-  "keywords": [
-    "dirac",
-    "string",
-    "text",
-    "manipulation"
-  ],
-  "author": "Dirac Community",
-  "license": "MIT",
-  "repository": {
-    "type": "git",
-    "url": "https://github.com/dirac-lang/dirac-string"
-  },
-  "bugs": {
-    "url": "https://github.com/dirac-lang/dirac-string/issues"
-  },
-  "homepage": "https://github.com/dirac-lang/dirac-string#readme",
-  "dirac": {
-    "version": ">=0.1.0",
-    "exports": {
-      "main": "lib/index.di"
-    }
-  }
-}

package/examples/scope-test-nested.di

@@ -1,60 +0,0 @@
-<!-- Test nested subroutine calls with variable scope -->
-<dirac>
-  <output>
-============ Test: Nested Subroutine Calls with Variable Scope ============
-  </output>
-  
-  <!-- Define main scope variables -->
-  <eval name="a">return "value-a"</eval>
-  <eval name="b">return "value-b"</eval>
-  <eval name="c">return "value-c"</eval>
-  
-  <output>
-Main scope: a=<variable name="a" />, b=<variable name="b" />, c=<variable name="c" />
-  </output>
-  
-  <!-- Subroutine that calls another subroutine -->
-  <subroutine name="outer-sub" param-x="type:string:" param-y="type:string:">
-    <output>  Outer subroutine - x: <variable name="x" />, y: <variable name="y" /></output>
-    
-    <!-- Define local variable in outer sub -->
-    <eval name="outer_local">return "outer-value"</eval>
-    <output>  Outer local: <variable name="outer_local" /></output>
-    
-    <!-- Call inner subroutine -->
-    <call name="inner-sub" p="$x" q="$y"/>
-    
-    <!-- Check outer variables still exist after inner call -->
-    <output>  After inner call - x: <variable name="x" />, y: <variable name="y" />, outer_local: <variable name="outer_local" /></output>
-  </subroutine>
-  
-  <!-- Inner subroutine -->
-  <subroutine name="inner-sub" param-p="type:string:" param-q="type:string:">
-    <output>    Inner subroutine - p: <variable name="p" />, q: <variable name="q" /></output>
-    <eval name="inner_local">return "inner-value"</eval>
-    <output>    Inner local: <variable name="inner_local" /></output>
-  </subroutine>
-  
-  <output>
-Calling outer-sub with a and b...
-  </output>
-  <call name="outer-sub" x="$a" y="$b"/>
-  
-  <output>
-After outer-sub, checking main scope:
-  a=<variable name="a" />, b=<variable name="b" />, c=<variable name="c" />
-  </output>
-  
-  <!-- Call outer-sub again to ensure no cumulative scope pollution -->
-  <output>
-Calling outer-sub AGAIN with b and c...
-  </output>
-  <call name="outer-sub" x="$b" y="$c"/>
-  
-  <output>
-After second outer-sub call:
-  a=<variable name="a" />, b=<variable name="b" />, c=<variable name="c" />
-
-============ Test Complete ============
-  </output>
-</dirac>

package/examples/scope-test.di

@@ -1,55 +0,0 @@
-<dirac>
-  <!-- Test library with two simple subroutines -->
-  <subroutine name="first-sub"
-              param-x="string"
-              param-y="string">
-    <output>First subroutine - x: <variable name="x" />, y: <variable name="y" /></output>
-  </subroutine>
-
-  <subroutine name="second-sub"
-              param-x="string"
-              param-y="string"
-              param-z="string">
-    <output>Second subroutine - x: <variable name="x" />, y: <variable name="y" />, z: <variable name="z" /></output>
-  </subroutine>
-
-  <!-- Main execution -->
-  <output>============ Test: Sequential Subroutine Calls ============</output>
-  <output></output>
-  
-  <!-- Define variables in main scope -->
-  <defvar name="x">value-x</defvar>
-  <defvar name="y">value-y</defvar>
-  <defvar name="z">value-z</defvar>
-  
-  <output>Variables defined in main scope:</output>
-  <output>  x = <variable name="x" /></output>
-  <output>  y = <variable name="y" /></output>
-  <output>  z = <variable name="z" /></output>
-  <output></output>
-  
-  <!-- Call first subroutine -->
-  <output>Calling first-sub with x="$x" y="$y"</output>
-  <first-sub x="$x" y="$y" />
-  <output></output>
-  
-  <!-- Check if variables still exist after first call -->
-  <output>After first-sub, checking main scope variables:</output>
-  <output>  x = <variable name="x" /></output>
-  <output>  y = <variable name="y" /></output>
-  <output>  z = <variable name="z" /></output>
-  <output></output>
-  
-  <!-- Call second subroutine -->
-  <output>Calling second-sub with x="$x" y="$y" z="$z"</output>
-  <second-sub x="$x" y="$y" z="$z" />
-  <output></output>
-  
-  <output>After second-sub, checking main scope variables:</output>
-  <output>  x = <variable name="x" /></output>
-  <output>  y = <variable name="y" /></output>
-  <output>  z = <variable name="z" /></output>
-  <output></output>
-  
-  <output>============ Test Complete ============</output>
-</dirac>

package/examples/seamless.di

@@ -1,45 +0,0 @@
-<!-- Seamless LLM-Dirac Interleaving - THE PHILOSOPHICAL DEMO -->
-<dirac>
-  <output>Seamless Execution Demo&#10;&#10;</output>
-  
-  <!-- Define a subroutine that lists files -->
-  <subroutine name="LIST_FILES">
-    <eval name="files">
-      return fs.readdirSync('examples')
-        .filter(f => f.endsWith('.di'))
-        .slice(0, 5)
-        .join(', ');
-    </eval>
-    <output>Files found: ${files}&#10;</output>
-  </subroutine>
-  
-  <!-- Define a subroutine that counts something -->
-  <subroutine name="COUNT_FILES">
-    <eval name="count">
-      return fs.readdirSync('examples').filter(f => f.endsWith('.di')).length;
-    </eval>
-    <output>Total count: ${count}&#10;</output>
-  </subroutine>
-  
-  <!-- Now the magic: LLM returns Dirac tags that get executed immediately -->
-  <output>Asking LLM to analyze and respond with executable tags...&#10;&#10;</output>
-  
-  <LLM execute="true" maxTokens="200">
-    You are analyzing a project directory. 
-    
-    Respond by calling ONLY these Dirac subroutines (XML tags):
-    - &lt;LIST_FILES /&gt; - lists example files
-    - &lt;COUNT_FILES /&gt; - counts total files
-    
-    Your response should be pure XML like:
-    &lt;dirac&gt;
-      &lt;output&gt;Analysis:&#10;&lt;/output&gt;
-      &lt;LIST_FILES /&gt;
-      &lt;COUNT_FILES /&gt;
-    &lt;/dirac&gt;
-    
-    Return ONLY the XML, no explanation.
-  </LLM>
-  
-  <output>&#10;Done!&#10;</output>
-</dirac>