Metadata-Version: 2.4
Name: boron-parallax
Version: 1.0.0
Summary: The World's First Timeline-Oriented Programming Language
Home-page: https://github.com/harsith/parallax
Author: Harsith
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: Topic :: Software Development :: Compilers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Requires-Python: >=3.10
Description-Content-Type: text/markdown
Requires-Dist: lark
Dynamic: author
Dynamic: classifier
Dynamic: description
Dynamic: description-content-type
Dynamic: home-page
Dynamic: requires-dist
Dynamic: requires-python
Dynamic: summary

# Parallax

**The World's First Timeline-Oriented Programming Language.**

Parallax is an experimental interpreted programming language that introduces quantum superposition as a first-class data type. Rather than utilizing iterative loops to determine optimal solutions, Parallax enables developers to split the execution timeline, filter for desired states, and collapse the results into deterministic outputs.

## Features

- **Superposition:** Variables can exist in multiple states simultaneously. A single variable assignment can spawn branching execution paths.
- **Entanglement:** State history is strictly preserved. Operations on superposed variables propagate across all active timelines automatically.
- **Declarative Pruning:** The `select` keyword allows for the declarative termination of timelines that fail to meet specific logical criteria, effectively optimizing the solution space without manual iteration.
- **VS Code Integration:** Includes full support for the Visual Studio Code environment, featuring custom syntax highlighting and file icon themes.

## Installation

The core language compiler and interpreter can be installed directly via pip:

```bash
pip install parallax-lang

// 1. Initialization
// Create a variable 'speed' that exists in 10 distinct states simultaneously.
let speed = superpose 1, 2, 3, 4, 5, 6, 7, 8, 9, 10

// 2. Execution
// Perform business logic. This mathematical operation executes across
// all 10 timelines instantly and independently.
let quality = 11 - speed
let profit = speed * quality

// 3. Pruning (Timeline Selection)
// Apply constraints to the system. We only retain timelines where
// the 'quality' metric exceeds 5. All other timelines are discarded.
select quality : value > 5

// 4. Observation
// Observe the remaining survivors in the 'profit' variable.
observe profit

// Output:
// The system returns the distribution of valid profit values
// from the surviving timelines (e.g., 10, 18, 24, 28, 30).

File Execution
To run a Parallax script file:

prlx script.prlx

Interactive REPL
To launch the Read-Eval-Print Loop for real-time experimentation:

prlx

Example Session:

>> let x = superpose 10, 20
>> observe x * 2
OBSERVED: 20: 50.0% | 40: 50.0%
