dirac-stdlib 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Zhi Wang
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,143 @@
+# dirac-stdlib
+
+Standard library for DIRAC - provides core utilities for math and string operations.
+
+**Status**: ✅ Production ready - All 24 unit tests passing
+
+## Features
+
+- ✅ **Math Operations**: ADD, SQUARE, FACTORIAL with Number() type coercion
+- ✅ **String Operations**: SUBSTRING, REPLACE, SPLIT, JOIN, TRIM, UPPERCASE, LOWERCASE, INDEXOF, INCLUDES, LENGTH, CONCAT
+- ✅ **Unit Tests**: Comprehensive test coverage (24 tests)
+- ✅ **Type Safety**: Automatic type coercion for robust handling
+
+## Installation
+
+```bash
+npm install dirac-stdlib
+```
+
+## Usage
+
+### Math Operations
+
+```xml
+<dirac>
+  <import src="dirac-stdlib/lib/math"/>
+  
+  <!-- Add two numbers -->
+  <call name="ADD" a="5" b="3" output="result"/>
+  <output><variable name="result"/></output> <!-- 8 -->
+  
+  <!-- Square a number -->
+  <call name="SQUARE" x="4" output="squared"/>
+  <output><variable name="squared"/></output> <!-- 16 -->
+  
+  <!-- Calculate factorial -->
+  <call name="FACTORIAL" num="5" output="fact"/>
+  <output><variable name="fact"/></output> <!-- 120 -->
+</dirac>
+```
+
+### String Operations
+
+```xml
+<dirac>
+  <import src="dirac-stdlib/lib/string.di"/>
+  
+  <!-- Extract substring -->
+  <call name="SUBSTRING" str="Hello World" start="0" length="5"/>
+  <!-- Output: Hello -->
+  
+  <!-- Replace text -->
+  <call name="REPLACE" str="Hello World" search="World" replace="DIRAC"/>
+  <!-- Output: Hello DIRAC -->
+  
+  <!-- Split string -->
+  <call name="SPLIT" str="apple,banana,cherry" delimiter=","/>
+  <!-- Output: 
+  apple
+  banana
+  cherry
+  -->
+  
+  <!-- Join array -->
+  <call name="JOIN" items="apple
+banana
+cherry" delimiter=", "/>
+  <!-- Output: apple, banana, cherry -->
+  
+  <!-- Trim whitespace -->
+  <call name="TRIM" str="  hello  "/>
+  <!-- Output: hello -->
+  
+  <!-- Case conversion -->
+  <call name="UPPERCASE" str="hello"/>
+  <!-- Output: HELLO -->
+  
+  <call name="LOWERCASE" str="WORLD"/>
+  <!-- Output: world -->
+  
+  <!-- Search operations -->
+  <call name="INDEXOF" str="hello world" search="world"/>
+  <!-- Output: 6 -->
+  
+  <call name="INCLUDES" str="hello world" search="world"/>
+  <!-- Output: true -->
+  
+  <!-- String length -->
+  <call name="LENGTH" str="hello"/>
+  <!-- Output: 5 -->
+  
+  <!-- Concatenate -->
+  <call name="CONCAT" str1="hello" str2=" world"/>
+  <!-- Output: hello world -->
+</dirac>
+```
+
+## API Reference
+
+### Math Operations
+
+- **ADD(a, b)**: Add two numbers
+- **SQUARE(x)**: Square a number
+- **FACTORIAL(num)**: Calculate factorial
+
+### String Operations
+
+- **SUBSTRING(str, start, [length])**: Extract portion of string
+- **REPLACE(str, search, replace, [regex])**: Replace text (supports regex with regex="true")
+- **SPLIT(str, delimiter)**: Split string by delimiter (returns newline-separated values)
+- **JOIN(items, [delimiter])**: Join newline-separated items with delimiter
+- **TRIM(str)**: Remove leading and trailing whitespace
+- **UPPERCASE(str)**: Convert to uppercase
+- **LOWERCASE(str)**: Convert to lowercase
+- **INDEXOF(str, search, [start])**: Find position of substring (-1 if not found)
+- **INCLUDES(str, search)**: Check if string contains substring (returns true/false)
+- **LENGTH(str)**: Get string length
+- **CONCAT(str1, str2)**: Concatenate two strings
+
+See [EXAMPLES.md](./EXAMPLES.md) for more usage examples.
+
+## Testing
+
+```bash
+npm test
+```
+
+All 24 unit tests passing:
+- 8 math operation tests
+- 16 string operation tests
+
+## Development
+
+This library requires `dirac-lang` as a devDependency for testing:
+
+```bash
+npm install
+npm test
+```
+
+## License
+
+MIT

package/lib/index.di

@@ -0,0 +1,8 @@
+<!-- DIRAC Standard Library -->
+<dirac>
+  <!-- Import math operations -->
+  <import src="./math.di"/>
+  
+  <!-- Import string operations -->
+  <import src="./string.di"/>
+</dirac>

package/lib/math.di

@@ -0,0 +1,25 @@
+<!-- Math utility library -->
+<dirac>
+  <!-- Square a number -->
+  <subroutine name="SQUARE" param-x="number">
+    <eval name="result">return Number(x) * Number(x);</eval>
+    <output><variable name="result" /></output>
+  </subroutine>
+  
+  <!-- Add two numbers -->
+  <subroutine name="ADD" param-a="number" param-b="number">
+    <eval name="result">return Number(a) + Number(b);</eval>
+    <output><variable name="result" /></output>
+  </subroutine>
+  
+  <!-- Calculate factorial -->
+  <subroutine name="FACTORIAL" param-num="number">
+    <eval name="result">
+      const n = parseInt(num, 10);
+      let fact = 1;
+      for (let i = 2; i &lt;= n; i++) fact *= i;
+      return fact;
+    </eval>
+    <output><variable name="result" /></output>
+  </subroutine>
+</dirac>

package/lib/string.di

@@ -0,0 +1,113 @@
+<!-- String Operations Library for DIRAC Standard Library -->
+<dirac>
+
+<!-- SUBSTRING: Extract portion of string -->
+<subroutine name="SUBSTRING" param-str="string" param-start="number" param-length="number (optional)">
+  <eval name="result">
+    const s = String(str);
+    const startPos = Number(start);
+    if (typeof length !== 'undefined' && length !== null && length !== '') {
+      return s.substring(startPos, startPos + Number(length));
+    } else {
+      return s.substring(startPos);
+    }
+  </eval>
+  <output><variable name="result" /></output>
+</subroutine>
+
+<!-- REPLACE: Replace text in string -->
+<subroutine name="REPLACE" param-str="string" param-search="string" param-replace="string" param-regex="boolean (optional)">
+  <eval name="result">
+    const s = String(str);
+    const searchStr = String(search);
+    const replaceStr = String(replace);
+    if (regex === 'true' || regex === true) {
+      return s.replace(new RegExp(searchStr, 'g'), replaceStr);
+    } else {
+      return s.split(searchStr).join(replaceStr);
+    }
+  </eval>
+  <output><variable name="result" /></output>
+</subroutine>
+
+<!-- SPLIT: Split string by delimiter -->
+<subroutine name="SPLIT" param-str="string" param-delimiter="string">
+  <eval name="result">
+    return String(str).split(String(delimiter)).join('\n');
+  </eval>
+  <output><variable name="result" /></output>
+</subroutine>
+
+<!-- JOIN: Join array elements (newline-separated input) -->
+<subroutine name="JOIN" param-items="string" param-delimiter="string (optional)">
+  <eval name="result">
+    const itemStr = String(items);
+    const delim = (typeof delimiter !== 'undefined' && delimiter !== null && delimiter !== '') ? String(delimiter) : '';
+    return itemStr.split('\n').join(delim);
+  </eval>
+  <output><variable name="result" /></output>
+</subroutine>
+
+<!-- TRIM: Remove whitespace from both ends -->
+<subroutine name="TRIM" param-str="string">
+  <eval name="result">
+    return String(str).trim();
+  </eval>
+  <output><variable name="result" /></output>
+</subroutine>
+
+<!-- UPPERCASE: Convert to uppercase -->
+<subroutine name="UPPERCASE" param-str="string">
+  <eval name="result">
+    return String(str).toUpperCase();
+  </eval>
+  <output><variable name="result" /></output>
+</subroutine>
+
+<!-- LOWERCASE: Convert to lowercase -->
+<subroutine name="LOWERCASE" param-str="string">
+  <eval name="result">
+    return String(str).toLowerCase();
+  </eval>
+  <output><variable name="result" /></output>
+</subroutine>
+
+<!-- INDEXOF: Find position of substring (returns -1 if not found) -->
+<subroutine name="INDEXOF" param-str="string" param-search="string" param-start="number (optional)">
+  <eval name="result">
+    const s = String(str);
+    const searchStr = String(search);
+    if (typeof start !== 'undefined' && start !== null && start !== '') {
+      return s.indexOf(searchStr, Number(start));
+    } else {
+      return s.indexOf(searchStr);
+    }
+  </eval>
+  <output><variable name="result" /></output>
+</subroutine>
+
+<!-- INCLUDES: Check if string contains substring (returns true/false) -->
+<subroutine name="INCLUDES" param-str="string" param-search="string">
+  <eval name="result">
+    return String(str).includes(String(search));
+  </eval>
+  <output><variable name="result" /></output>
+</subroutine>
+
+<!-- LENGTH: Get string length -->
+<subroutine name="LENGTH" param-str="string">
+  <eval name="result">
+    return String(str).length;
+  </eval>
+  <output><variable name="result" /></output>
+</subroutine>
+
+<!-- CONCAT: Concatenate strings -->
+<subroutine name="CONCAT" param-str1="string" param-str2="string">
+  <eval name="result">
+    return String(str1) + String(str2);
+  </eval>
+  <output><variable name="result" /></output>
+</subroutine>
+
+</dirac>

package/package.json

@@ -0,0 +1,32 @@
+{
+  "name": "dirac-stdlib",
+  "version": "0.1.0",
+  "description": "Standard library for DIRAC - Math and String operations",
+  "main": "lib/index.di",
+  "type": "module",
+  "scripts": {
+    "test": "node scripts/test.js"
+  },
+  "files": [
+    "lib/"
+  ],
+  "keywords": [
+    "dirac",
+    "stdlib",
+    "math",
+    "string"
+  ],
+  "author": "Zhi Wang",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/wangzhi63/dirac-stdlib.git"
+  },
+  "bugs": {
+    "url": "https://github.com/wangzhi63/dirac-stdlib/issues"
+  },
+  "homepage": "https://github.com/wangzhi63/dirac-stdlib#readme",
+  "devDependencies": {
+    "dirac-lang": "^0.1.26"
+  }
+}