Repository navigation
Releases
2.1.0
🚀 Release v2.1.0 (Zero-IndexMap Lexing & Structural Block Tokens)
This release fundamentally simplifies the text-processing layers: the preprocessor is now a pure format adapter, all comment / N-code / whitespace filtering has moved inline into the lexer, and block boundaries travel through the pipeline as first-class NewLine tokens. As a side effect, row counting for diagnostics after multi-line comments is now correct.
✨ Added
- Structural Block Tokens: Introduced
TokenKind.NewLineandNodeKind.NewLineas first-class pipeline entities. The interpreter no longer scans characters or counts rows - frame boundaries are driven exclusively by marker nodes emitted by the parser. - Four Independent Trivia Helpers:
LexingHelpernow exposesSkipWhitespaces,SkipBlockComment,SkipLineComment, andSkipLineNumberas individually testable primitives.SkipWhitespacesdeliberately excludes'\n'so structural boundaries can be emitted by the lexer.
🔄 Changed
- Preprocessor Is Now a Pure Format Adapter:
VeloxMemoryPreprocessoronly copies raw input characters into theMemoryArena. All comment, N-code, and whitespace filtering is performed inline during lexing. PreprocessingResultSlimmed Down: RemovedIndexMapPtr/IndexMapand the associatedint[]buffer. The stored text is now byte-for-byte identical to the original source, so downstream offsets are already absolute.- Parser Collapses Empty Frames:
NodeKind.NewLineis materialized only between blocks that actually contained content. Empty source lines, comment-only lines, and trailing line endings no longer produce spurious frames. - Interpreter Simplified: Removed the
currentTextIndex/currentRow/currentFrameRowtracking state and the per-node character scan. Frame flushing is now driven byNodeKind.NewLine, with a singlependingFrameContentflush at end-of-stream.
🐛 Fixed
- Row Counting After Multi-Line Comments:
IndexMapper.GetRowColumnnow returns correct row numbers for diagnostics emitted after a parenthesized comment that spans multiple physical lines. Previously,\ninside(...)was stripped by the preprocessor and the reported row was shifted.
⚡ Performance
- Lower Preprocessing Overhead: Eliminated per-character
IndexMapwrites - the preprocessor now performs a singleSpan.CopyTointo the arena. Smaller memory footprint, better cache locality. - Cheaper Interpreter Hot Loop: The interpreter no longer walks the source buffer between nodes; block boundaries arrive as tokens. Large files with many blocks benefit the most.
⚠️ Known Limitations
- Comment Inside a Numeric Literal: An input such as
G0(comment)1- invalid per ISO 6983 - now produces two separateNumbertokens instead of being transparently merged. This is a consequence of inline trivia handling and is documented as a deliberate trade-off.
📦 Installation
dotnet add package MachineGate.NG.Velox --version 2.1.02.0.4
🚀 Release v2.0.4 (NuGet Package Rendering & Asset Fixes)
This release addresses critical visual defects on nuget.org and refines the internal package structure for better downstream compatibility.
🛠 What's New in v2.0.4
- Fixed NuGet Image Rendering: Resolved the long-standing issue where validation graphs (
numpy_validation.png,cimco_ethalon.png) appeared broken on nuget.org. Root cause traced to 32-bit RGBA PNG format - all assets converted to 24-bit sRGB with stripped metadata for guaranteed rendering on Microsoft's package gallery. - Restructured Package Assets: Moved embedded documentation images from the package root to the canonical
docs/images/path, aligning with NuGet packaging best practices and eliminating root clutter. - Hardened Packaging Configuration: Updated
.csprojpackaging directives to enforce explicitPackagePathmappings, ensuring deterministic asset layout inside the.nupkgstream.
📦 Installation
dotnet add package MachineGate.NG.Velox --version 2.0.42.0.3
🚀 Release v2.0.3 (NuGet Badges & Package Rendering Fixes)
This release enhances package discoverability and fixes visual presentation issues on nuget.org by adding status badges and correcting image path resolution.
🛠 What's New in v2.0.3
- NuGet Status Badges: Added live-updating Shields.io badges to the GitHub README:
- Package version badge - always reflects the latest published release
- Total downloads badge - tracks lifetime package adoption
- Fixed NuGet Image Rendering: Resolved broken image display on nuget.org by switching to explicit relative paths (
./image.png) in the embedded package README. All validation graphs now render correctly on downstream package galleries. - Refined Package Metadata: Tightened
.csprojpackaging configuration for seamless compatibility with nuget.org's README and asset resolution pipeline.
📦 Installation
dotnet add package MachineGate.NG.Velox --version 2.0.3v2.0.2
🚀 Release v2.0.2 (Telemetry & Advanced Documentation Packaging)
This release focuses on improving the stability of automated workflows, fixing target endpoint issues, and drastically enhancing asset management for downstream platforms (like nuget.org).
🛠 What's New in v2.0.2
- Dual-README Architecture: Decoupled documentation paths.
README.mdremains a full-featured deployment hub optimized for GitHub.README.NuGet.mdis now built natively into the.nupkgpayload (mapped to rootREADME.md), removing non-essential developer sections for consumer ease.
- Isolated Asset Bundling: Mathematical telemetry graphs (
numpy_validation.pngandcimco_ethalon.png) are now fully packed inside the root of the.nupkgstream with clean O(1) package paths. No more broken layout images or rendering issues on downstream target endpoints! - Fixed Endpoint Redirection: Resolved the critical deployment bugs related to endpoint resolution. Internal
dotnet nuget pushparameters are now explicitly anchored to the modernhttps://nuget.orgOIDC gateway. - JIT-Optimized Deterministic Toolchains: Restored absolute tracking state parameters inside GitHub Actions via deterministic flags.
📦 Installation
dotnet add package MachineGate.NG.Velox --version 2.0.22.0.1
🚀 Release v2.0.1 (Production Ready & Developer Experience Update)
This release focuses on significantly improving the developer experience (DX) for integration and troubleshooting, alongside updating the pipeline deployment automation.
🛠 What's New in v2.0.1
- Full SourceLink Debugging Integration: Debugging Symbols (
.pdb) are now deeply embedded inside the NuGet package. Developers using this library can seamlessly Step Into (F11) hot paths (pipeline.Process(...),MemoryArena, raw pointers) directly from Visual Studio or Rider without cloning the repository manually. - Deterministic Builds Enabled: Compiled in a standardized CI environment with
/p:DeterministicSourcePaths=true, ensuring that binaries strictly match the source commit hashes on GitHub. - Advanced Pipeline Synchronization: The end-to-end telemetry and installation workflows inside
README.md(including headers anddotnet addcommands) are now fully automated and kept in perfect sync with Git tags upon deployment.
📦 Installation
dotnet add package MachineGate.NG.Velox --version 2.0.1v2.0.0 - The Unmanaged Arena Release
🚀 Release v2.0.0 (Initial Public Release)
Welcome to the first public release of MachineGate.NG.Velox! This is a complete systems-level rewrite optimized for .NET 10, delivering a zero-allocation, ultra-high-performance G-code processing pipeline with native C/C++ speed.
⚡ Performance & Core Architecture
- Absolute Zero-Allocation (GC-Free): The entire end-to-end pipeline operates with 0 B managed heap allocations using a custom unmanaged
MemoryArena. Garbage Collection pauses are completely eliminated. - Extreme Throughput: Processes ~400,000 lines of G-code per second (validated on Intel i5-10400F, .NET 10.0, X64 RyuJIT AVX2).
- Systems-Level Optimizations:
- Branchless lexing via
CharRegistryexpandedushortbitmasks. - Explicit 16-byte AST
Nodestruct unions for maximum L1/L2 cache locality. - Raw pointer arithmetic (
T*) in hot paths to bypass array bounds checking.
- Branchless lexing via
🛠 Industrial Kinematics & Dual Pipeline
- Advanced Motion Planning: Implements full S-Curve (jerk-limited) acceleration profiles, Look-Ahead planning, and Junction Deviation.
- UVW Plane Normalization: Unified mathematical paths for G17/G18/G19 planes.
- Dual Output Targets:
- Hardware Target: Packs toolpaths into dense, zero-copy binary structures for direct UART/Ethernet microcontroller transmission.
- Simulation Target: Generates unmanaged
SimulationFramestructures pointing directly to arena memory for high-speed visualization.
- Precise Diagnostics: Integrated
IndexMapto trace preprocessed characters back to original source code lines.
📦 Installation
dotnet add package MachineGate.NG.Velox --version 2.0.0Note: For complete implementation details and code snippets for both Hardware and Simulation pipelines, please refer to the updated README.md in the repository root.