save README updates

Author: gbenroscience

.specstory/cli/config.toml

@@ -0,0 +1,79 @@
+# SpecStory CLI Configuration
+#
+# This is the project-level config file for SpecStory CLI.
+# All settings here apply to this project unless overridden by CLI flags.
+#
+# Uncomment (remove the #) the line and edit any setting below to change the default behavior.
+# For more information, see: https://docs.specstory.com/integrations/terminal-coding-agents/usage
+
+[local_sync]
+# Write markdown files locally. (default: true)
+# enabled = false # equivalent to --only-cloud-sync
+
+# Custom output directory for markdown files.
+# Default: ./.specstory/history (relative to the project directory)
+# output_dir = "~/.specstory/history" # equivalent to --output-dir "~/.specstory/history"
+
+# Use local timezone for file name and content timestamps (default: false, UTC)
+# local_time_zone = true # equivalent to --local-time-zone
+
+[cloud_sync]
+# Sync session data to SpecStory Cloud. (default: true, when logged in to SpecStory Cloud)
+# enabled = false # equivalent to --no-cloud-sync
+
+[logging]
+# Write logs to .specstory/debug/debug.log (default: false)
+# log = true # equivalent to --log        
+
+# Debug-level output, requires console or log (default: false)
+# debug = true # equivalent to --debug 
+
+# Custom output directory for debug data.
+# Default: ./.specstory/debug (relative to the project directory)
+# debug_dir = "~/.specstory/debug" # equivalent to --debug-dir "~/.specstory/debug"
+
+# Error/warn/info output to stdout (default: false)
+# console = true # equivalent to --console
+
+# Suppress all non-error output (default: false)
+# silent = true	# equivalent to --silent
+
+[version_check]
+# Check for new versions of the CLI on startup.
+# Default: true
+# enabled = false # equivalent to --no-version-check
+
+[analytics]
+# Send anonymous product usage analytics to help improve SpecStory.
+# Default: true
+# enabled = false # equivalent to --no-usage-analytics
+
+[telemetry]
+# OTLP gRPC collector endpoint (e.g., "localhost:4317" or "http://localhost:4317")
+# endpoint = "localhost:4317"
+
+# Override the default service name (default: "specstory-cli")
+# service_name = "my-service-name"
+
+# Include user prompt text in telemetry spans (default: true)
+# prompts = false
+
+[providers]
+# Agent execution commands by provider (used by specstory run)
+# Pass custom flags (e.g. claude_cmd = "claude --allow-dangerously-skip-permissions")
+# Use of these is equivalent to -c "custom command"
+
+# Claude Code command
+# claude_cmd = "claude"
+
+# Codex CLI command
+# codex_cmd = "codex"
+
+# Cursor CLI command
+# cursor_cmd = "cursor-agent"
+
+# Droid CLI command
+# droid_cmd = "droid"
+
+# Gemini CLI command
+# gemini_cmd = "gemini"

.vscode/settings.json

@@ -0,0 +1,3 @@
+{
+    "specstory.cloudSync.enabled": "never"
+}

LATEST.md

@@ -1,5 +1,8 @@
 # ParserNG
 
+Parser 1.0.3 has been released on maven-central!
+Maintaining the industry standard besting speeds of v1.0.x, it adds the functionality of rotational geometry.
+In v1.0.3, you can use the rotor function, `rot` to rotate raw points in 3D space and other functions such as curves, lines, surfaces(both plane and curved) and 3D equations of all sorts.
 
 ParserNG 1.0.2 has been released on maven-central!
 Version 1.0.2 retains the wild speeds of Version 1.0.1. Adds an extra widening technique of variable passing to the Turbo mode,

LOGICAL.md

@@ -133,7 +133,7 @@ In CLI, you can use -e/-E/--expanding switch to work with Expanding expressions.
 <br>
 Example:<br>
 ```
-VALUES_PNG="1 8 5 2" java -jar target/parser-ng-0.2.2.jar -e "avg(..L{MN/2})*1.1-MN <  L0 | (L1+L{MN-1})*1.3 + MN<  L0" -v
+VALUES_PNG="1 8 5 2" java -jar target/parser-ng-1.0.3.jar -e "avg(..L{MN/2})*1.1-MN <  L0 | (L1+L{MN-1})*1.3 + MN<  L0" -v
 avg(..L{MN/2})*1.1-MN <  L0 | (L1+L{MN-1})*1.3 + MN<  L0 
 Expression : avg(..L{MN/2})*1.1-MN <L0 | (L1+L{MN-1})*1.3 + MN<L0 
 Upon       : 1,8,5,2

MORE.md

@@ -1,5 +1,5 @@
 # ParserNG
-<b>ParserNG</b> is a powerful open-source math tool that parses and evaluates algebraic expressions and also knows how to handle a lot of mathematical expressions. Its latest release on mavn-central (version 0.2.1) can be used to plot 2D graphs(Geometric plots and function plots) It works seamlessly on all Java platforms.<br><br>
+<b>ParserNG</b> is a powerful open-source math tool that parses and evaluates algebraic expressions and also knows how to handle a lot of mathematical expressions. Its latest release on mavn-central (version 1.0.31) can be used to plot 2D graphs(Geometric plots and function plots) It works seamlessly on all Java platforms.<br><br>
 
 
 
@@ -8,15 +8,15 @@
       Click the Sponsor button to do this.
 
 
-ParserNG v0.2.3 breaks the barrier in fully featured math parser frequencies!
-With various other optimizations, v0.2.3 comes with inner loop optimizations which uses a blazing fast, post-fix style algorithm to quickly evaluate inner brackets with less checks and less string manipulations.
+ParserNG v1.0.3 breaks the barrier in fully featured math parser frequencies!
+With various other optimizations, v1.0.3 comes with inner loop optimizations which uses a blazing fast, post-fix style algorithm to quickly evaluate inner brackets with less checks and less string manipulations.
 This obviously will make graphing and other iterative tasks super responsive.
 
-ParserNG v0.2.4 is an extremely feature rich math tool which also doubles as (arguably) the fastest pure Java expression evaluator on the planet.
+ParserNG v1.0.34 is an extremely feature rich math tool which also doubles as (arguably) the fastest pure Java expression evaluator on the planet.
 In benchmarks, it beats com.expression.parser(Java Math Expression Parser) by almost (10x-14x) and edges out Exp4J (which is lightweight) in many benchmarks.
 
 
-ParserNG 0.2.5 features strength reduction, constant folding and execution frame(array) based args passing(in contrast to Map based) to ensure O(1) complexity in passage of args to the evaluation stage.
+ParserNG 1.0.35 features strength reduction, constant folding and execution frame(array) based args passing(in contrast to Map based) to ensure O(1) complexity in passage of args to the evaluation stage.
 
 [Here are a few benchmarks here](./BENCHMARK_RESULTS.md)
 
@@ -68,7 +68,7 @@ If you need to access this library via Maven Central, do:
         <dependency>
             <groupId>com.github.gbenroscience</groupId>
             <artifactId>parser-ng</artifactId>
-            <version>0.2.3</version>
+            <version>1.0.3</version>
         </dependency>
        
 
@@ -101,20 +101,20 @@ ParserNG is written completely in (pure) Java and so is as cross-platform as Jav
 ## Using ParserNG as commandline tool
 You can use jar directly as commandline calculus. Unless the tool is packed to your distribution:
 ```
-java -jar parser-ng-0.2.3.jar  1+1
+java -jar parser-ng-1.0.3.jar  1+1
 2.0
 ```
 Or as logical parser
 ```
-java -jar parser-ng-0.2.3.jar -l true and true
+java -jar parser-ng-1.0.3.jar -l true and true
 true
-java -jar parser-ng-0.2.3.jar -l "2 == (4-2)"
+java -jar parser-ng-1.0.3.jar -l "2 == (4-2)"
 true
 ```
 You can get help by 
 ```
-java -jar parser-ng-0.2.3.jar  -h
-  ParserNG 0.2.3 math.Main
+java -jar parser-ng-1.0.3.jar  -h
+  ParserNG 1.0.3 math.Main
 -h/-H/--help         this text; do not change for help (witout dashes), which lists functions
 -v/-V/--verbose      output is reprinted to stderr with some inter-steps
 -l/-L/--logic        will add logical expression wrapper around the expression
@@ -136,11 +136,11 @@ java -jar parser-ng-0.2.3.jar  -h
 ```
 You  can get examples by verbose help:
 ```
-java -jar parser-ng-0.2.3.jar  -h -v
+java -jar parser-ng-1.0.3.jar  -h -v
 ```
 you can list functions:
 ```
-java -jar parser-ng-0.2.3.jar  help
+java -jar parser-ng-1.0.3.jar  help
 List of currently known methods:
 acos        - help not yet written. See https://github.com/gbenroscience/ParserNG
 ...
@@ -149,7 +149,7 @@ List of functions is just tip of iceberg, see: https://github.com/gbenroscience/
 ```
 you can list logical operators:
 ```
-java -jar parser-ng-0.2.3.jar  -l help
+java -jar parser-ng-1.0.3.jar  -l help
 Comparing operators: !=, ==, >=, <=, le, ge, lt, gt, <, >
 Logical operators: impl, xor, imp, eq, or, and, |, &
 As Mathematical parts are using () as brackets, Logical parts must be grouped by [] eg.
@@ -164,40 +164,40 @@ Program can work with stdin, out and err properly. Can work with multiline input
 ### cmdline examples
 Following lines describes, how stdin/arguments are processed, and how different is input/output with `-t` on/off
 ```
-   java -jar parser-ng-0.2.3.jar -h
+   java -jar parser-ng-1.0.3.jar -h
     this help
-  java -jar parser-ng-0.2.3.jar 1+1
+  java -jar parser-ng-1.0.3.jar 1+1
     2.0
-  java -jar parser-ng-0.2.3.jar "1+1
+  java -jar parser-ng-1.0.3.jar "1+1
                                  +2+2"
     2.0
     4.0
-  java -jar parser-ng-0.2.3.jar -t "1+1
+  java -jar parser-ng-1.0.3.jar -t "1+1
                                     +2+2"
     6.0
-  java -jar parser-ng-0.2.3.jar -i  1+1
+  java -jar parser-ng-1.0.3.jar -i  1+1
     nothing, will expect manual output, and calculate line by line
-  java -jar parser-ng-0.2.3.jar -i -t  1+1
+  java -jar parser-ng-1.0.3.jar -i -t  1+1
     nothing, will expect manual output and calcualte it all as one expression
-  echo 2+2 | java -jar parser-ng-0.2.3.jar  1+1
+  echo 2+2 | java -jar parser-ng-1.0.3.jar  1+1
     2.0
   echo "1+1 
-        +2+2 | java -jar parser-ng-0.2.3.jar -i
+        +2+2 | java -jar parser-ng-1.0.3.jar -i
     2.0
     4.0
   echo "1+1 
-        +2+2 | java -jar parser-ng-0.2.3.jar -i -t
+        +2+2 | java -jar parser-ng-1.0.3.jar -i -t
     6.0
-  java -cp parser-ng-0.2.3.jar parser.cmd.ParserCmd "1+1
+  java -cp parser-ng-1.0.3.jar parser.cmd.ParserCmd "1+1
     will ask for manual imput en evaluate per line
   echo "1+1 
-        +2+2 | java -cp parser-ng-0.2.3.jar parser.cmd.ParserCmd 2>/dev/null
+        +2+2 | java -cp parser-ng-1.0.3.jar parser.cmd.ParserCmd 2>/dev/null
     2.0
     4.0
-  java -cp parser-ng-0.2.3.jar parser.MathExpression "1+1
+  java -cp parser-ng-1.0.3.jar parser.MathExpression "1+1
                                                       +2+2"
     6.0
-  java -cp parser-ng-0.2.3.jar parser.LogicalExpression "true or false"
+  java -cp parser-ng-1.0.3.jar parser.LogicalExpression "true or false"
     true
 
 ```
@@ -773,7 +773,7 @@ This would give:
 
 #### ParserNG and eigenvalues
 
-Version 0.2.3 of ParserNG allows you to quickly compute the eigenvalues of a Matrix.
+Version 1.0.3 of ParserNG allows you to quickly compute the eigenvalues of a Matrix.
 
 Do:
 ```Java
@@ -782,7 +782,7 @@ Do:
 ```
 #### ParsrNG and eigenvectors
 
-As of ParserNG 0.2.3 also, eigenvector computations have been added, do:
+As of ParserNG 1.0.3 also, eigenvector computations have been added, do:
 Do:
 ```Java
     MathExpression expression = new MathExpression("eigvec(@(5,5)(12,1,4,2,9,3,1,8,-5,6,13,9,7,3,5,7,3,5,4,9,13,2,4,8,6))");

PERFORMANCE_TUNING.md

@@ -1,4 +1,4 @@
-This section is designed to help you squeeze every last nanosecond out of **ParserNG 1.0.2**. Because the engine utilizes a JIT-native architecture via `MethodHandle` trees, its performance characteristics differ significantly from traditional interpreted parsers.
+This section is designed to help you squeeze every last nanosecond out of **ParserNG 1.0.3**. Because the engine utilizes a JIT-native architecture via `MethodHandle` trees, its performance characteristics differ significantly from traditional interpreted parsers.
 
 ---
 
@@ -17,7 +17,7 @@ ParserNG offers two primary execution paths. Choosing the right one depends on y
 ---
 
 ### 2. The Power of Constant Folding
-Version 1.0.2 introduces aggressive **Constant Folding**. This optimization happens during the compilation phase, where the parser identifies sub-expressions that result in a constant value and "pre-calculates" them.
+Version 1.0.3 introduces aggressive **Constant Folding**. This optimization happens during the compilation phase, where the parser identifies sub-expressions that result in a constant value and "pre-calculates" them.
 
 * **Static Expression:** `sin(3.14159 / 2) + x`
 * **Folded Expression:** `1.0 + x`
@@ -72,7 +72,7 @@ for (int i = 0; i < 1_000_000; i++) {
 ---
 
 ### 6. JDK Version Matters
-ParserNG 1.0.2 is optimized for **modern JDKs (17, 21, and 24)**. Improvements in the `java.lang.invoke` package in later versions directly translate to faster "Turbo" execution. If you are running on JDK 8 or 11, you may see slightly higher latencies due to less efficient `MethodHandle` inlining.
+ParserNG 1.0.3 is optimized for **modern JDKs (17, 21, and 24)**. Improvements in the `java.lang.invoke` package in later versions directly translate to faster "Turbo" execution. If you are running on JDK 8 or 11, you may see slightly higher latencies due to less efficient `MethodHandle` inlining.
 
 ---
 

README.md

@@ -1,6 +1,6 @@
 # ParserNG 🧮⚡
 
-**ParserNG 1.0.2** is a **blazing-fast**, nigh zero allocation(memory wise), **pure Java**, **zero-native-dependencies** math expression parser and evaluator.
+**ParserNG 1.0.3** is a **blazing-fast**, nigh zero allocation(memory wise), **pure Java**, **zero-native-dependencies** math expression parser and evaluator.
 
 It **beats Janino, exp4J, and com.expression.parser on evaluation speed** across every kind of expression — from simple algebra to heavy trig, matrices, and calculus.  
 The normal mode routinely does about **3-10 million evaluations per second** while the new Turbo mode easily peaks at about **10 million to 90 million evaluations per second**.
@@ -12,11 +12,11 @@ Perfect for scientific computing, simulations, real-time systems, education tool
 [![Maven Central](https://img.shields.io/maven-central/v/com.github.gbenroscience/parser-ng.svg?label=Maven%20Central)](https://central.sonatype.com/artifact/com.github.gbenroscience/parser-ng)
 [![License](https://img.shields.io/github/license/gbenroscience/ParserNG?color=blue)](https://github.com/gbenroscience/ParserNG/blob/master/LICENSE)
 ![Java](https://img.shields.io/badge/Java-8%2B-orange)
-![Latest Version](https://img.shields.io/badge/version-1.0.2-success)
+![Latest Version](https://img.shields.io/badge/version-1.0.3-success)
 
-> **1.0.2** introduces **Turbo Scalar** and **Turbo Matrix** compiled paths + massive speed improvements via strength reduction, constant folding, and O(1) frame-based argument passing.
+> **1.0.3** introduces **Turbo Scalar** and **Turbo Matrix** compiled paths + massive speed improvements via strength reduction, constant folding, and O(1) frame-based argument passing.
 
-## ✨ Highlights (v1.0.2)
+## ✨ Highlights (v1.0.3)
 
 - **Speed champion** — beats Janino in most benchmarks, and exp4J, com.expression.parser and Parsii in every benchmark (see [BENCHMARK_RESULTS.md](BENCHMARK_RESULTS.md))
 - **Turbo Mode** — compile once, evaluate millions of times per second (Scalar + Matrix paths)
@@ -36,14 +36,14 @@ Perfect for scientific computing, simulations, real-time systems, education tool
 <dependency>
     <groupId>com.github.gbenroscience</groupId>
     <artifactId>parser-ng</artifactId>
-    <version>1.0.2</version>
+    <version>1.0.3</version>
 </dependency>
 ```
 
 Also available on **Maven Central**:  
-https://central.sonatype.com/artifact/com.github.gbenroscience/parser-ng/1.0.2
+https://central.sonatype.com/artifact/com.github.gbenroscience/parser-ng/1.0.3
 
-## ⚡ Turbo Mode — The 1.0.2 Game Changer
+## ⚡ Turbo Mode — The 1.0.3 Game Changer
 
 ```java
 import com.github.gbenroscience.parser.MathExpression;
@@ -128,13 +128,40 @@ MathExpression expr = new MathExpression("""
 System.out.println("Determinant = " + expr.solve());
 ```
 
+
+### 6. ROTOR
+You may use the rot function to rotate functions, surfaces(plane or curved), lines and even raw points in 3D space.
+
+To rotate any of these, you need the orbital center, the coordinates of the direction vector(a,b,c) and the angle of rotation.
+
+The example below shows two ways to use the ParserNG library to rotate the point `p` and `q` about the orbital center (1,0,1)
+with the directio vector,(1,1,0). The angle of rotation is pi radians.
+
+```Java
+ String expression = "p=@(1,3)(4,2,5);q=@(1,3)(12,3,-1);rot(p,q, pi, @(1,3)(1,0,1),@(1,3)(1,1,0))";
+        MathExpression interpreted = new MathExpression(expression);
+
+        MathExpression.EvalResult ev = interpreted.solveGeneric(); 
+        System.out.printf("Expression: %s%n", expression);
+        System.out.println("interpreted: " + ev);
+
+        // Compile to turbo
+        FastCompositeExpression compiled = new ScalarTurboEvaluator(interpreted, true).compile();
+        // Warm up turbo JIT
+        double[] vars = new double[0]; 
+        MathExpression.EvalResult evr = compiled.apply(vars);
+        System.out.println("turbo: " + evr);
+```
+
+
+ 
 ## ⌨️ Command-line tool (REPL)
 
 ```bash
-java -jar parser-ng-1.0.2.jar "sin(x) + cos(x)"
-java -jar parser-ng-1.0.2.jar "eigvalues(R=@(5,5)(...))"
-java -jar parser-ng-1.0.2.jar help
-java -jar parser-ng-1.0.2.jar -i          # interactive mode
+java -jar parser-ng-1.0.3.jar "sin(x) + cos(x)"
+java -jar parser-ng-1.0.3.jar "eigvalues(R=@(5,5)(...))"
+java -jar parser-ng-1.0.3.jar help
+java -jar parser-ng-1.0.3.jar -i          # interactive mode
 ```
 
 ## 📊 Supported Features at a Glance
@@ -155,8 +182,8 @@ Full list: run `help` or `new MathExpression("help").solve()`.
 
 - [BENCHMARK_RESULTS.md](BENCHMARK_RESULTS.md) — full speed comparisons
 - [GRAPHING.md](GRAPHING.md) — plotting on Swing / JavaFX / Android
-- [LATEST.md](LATEST.md) — what’s new in 1.0.2
-- Javadoc: https://javadoc.io/doc/com.github.gbenroscience/parser-ng/1.0.2
+- [LATEST.md](LATEST.md) — what’s new in 1.0.3
+- Javadoc: https://javadoc.io/doc/com.github.gbenroscience/parser-ng/1.0.3
 
 ## ❤️ Support the Project
 
@@ -173,7 +200,7 @@ ParserNG is built with love in my free time. If it helps you:
 
 ---
 
-**ParserNG 1.0.2** — faster than the competition, stronger on matrices, and now with real Turbo Scalar + Turbo Matrix compiled power.
+**ParserNG 1.0.3** — faster than the competition, stronger on matrices, and now with real Turbo Scalar + Turbo Matrix compiled power.
 
 Happy parsing! 🚀  
 — **GBENRO JIBOYE** (@gbenroscience)