Welcome to Rakexl, an opinionated extended grammar for the JEXL expression parser and evaluator with 80+ built-in functions.

Quick Example

import jexl from 'rakexl';
const result = jexl.evalSync('user.name | uppercase', { user: { name: 'John' } });
// "JOHN"

Language Guide

📖 Language Reference

• Syntax Overview - Basic JEXL syntax rules
• Data Types - Strings, numbers, arrays, objects
• Operators - Arithmetic, comparison, logical operators
• Expressions - Complex expression patterns
• Context and Variables - Working with data context

� Function Reference

Complete documentation for all 80+ functions:

• Array Functions - Collection processing
• String Functions - Text manipulation
• Math Functions - Numerical operations
• Date/Time Functions - Date handling
• Utility Functions - Helpers and conversions

Usage Guides

JavaScript/TypeScript

• Installation with npm/yarn
• Basic usage and integration patterns
• Monaco Editor setup with IntelliSense
• TypeScript support and type definitions
• Performance optimization techniques

Interactive Playground

Try Rakexl expressions online with our interactive playground:

Launch Playground →

The playground features:

• Live Expression Editor - Monaco Editor with syntax highlighting and IntelliSense
• Real-time Evaluation - See results as you type
• Sample Data - Pre-loaded with example contexts
• Save & Share - Save your expressions for later
• Examples Library - Learn from practical examples

📖 Playground Guide - Learn how to use all playground features

Key Features

• 🚀 80+ Built-in Functions - String manipulation, math, arrays, objects, dates, and more
• 🎨 Monaco Editor Support - Syntax highlighting, IntelliSense, and hover documentation
• 📝 TypeScript Support - Full type definitions included
• 🔧 Modular - Use the entire library or import individual functions

Examples

Data Transformation

// Transform an array of users
const users = [
  { name: "Alice", age: 28, department: "Engineering" },
  { name: "Bob", age: 32, department: "Marketing" },
  { name: "Charlie", age: 24, department: "Engineering" }
];

// Get names of engineers older than 25
jexl.evalSync('users|filter("value.department == \\"Engineering\\" && value.age > 25")|map("value.name")', { users });
// ["Alice"]

String Processing

// Process and format text
jexl.evalSync('"hello world" | uppercase | split(" ") | join("-")');
// "HELLO-WORLD"

Mathematical Operations

// Calculate statistics
jexl.evalSync('numbers | sum / length(numbers)', { numbers: [1, 2, 3, 4, 5] });
// 3 (average)

Contributing

Rakexl is open source. Contributions are welcome! Please see our GitHub repository for more information.

License

MIT License - see LICENSE file for details.