lumina-lang 0.3.0

package/CHANGELOG.md

@@ -0,0 +1,17 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+## Unreleased
+
+## 0.3.0 - 2026-02-14
+
+- **Breaking:** Removed the `parsergen` binary. Use `lumina grammar` for parser generator tooling.
+- **Rename:** Package published as `lumina-lang` (formerly `parsergen-starter`).
+- Lumina language pipeline (lexer, parser, semantic checks, IR, codegen).
+- Multi-file project context with panic recovery and dependency graph.
+- Lumina LSP server (diagnostics, completion, symbols, rename, references, semantic tokens).
+- CLI enhancements (`lumina`, `lumina-lsp`, `parsergen` updates).
+- Optimizations (constant folding, dead code elimination, constant propagation).
+- **Fix:** SSA IR codegen now hoists SSA temporaries and avoids loop-unsafe constant folding.
+- Source maps support and improved watcher tooling.

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 nyigoro
+
+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,243 @@
+# Lumina (v0.3.0)
+
+A modern functional language with async/await, type inference, and package management.
+
+![npm](https://img.shields.io/npm/v/lumina-lang?color=blue)
+![npm downloads](https://img.shields.io/npm/dm/lumina-lang)
+![MIT License](https://img.shields.io/npm/l/lumina-lang)
+![GitHub release](https://img.shields.io/github/v/release/nyigoro/lumina-lang)
+![Build](https://img.shields.io/github/actions/workflow/status/nyigoro/lumina-lang/ci.yml?branch=main)
+
+## ✨ Highlights
+
+- PEG grammar compiler with AST output
+- Streaming parsing with custom delimiters
+- REPL with multiline input, history, AST views, profiling, and clipboard helpers
+- Lumina language pipeline (lexer, parser, semantic checks, IR, codegen)
+- Project context for multi-file parsing + panic mode recovery
+- Lumina LSP server with diagnostics, completion, symbols, rename, references, semantic tokens
+- CLI tools for parsing and Lumina workflows
+  - Structs/enums with match + member access
+  - Hex/binary/underscored numeric literals
+  - IR visualization via `--debug-ir`
+
+## 📦 Installation
+
+```bash
+npm install -g lumina-lang
+# or
+pnpm add -D lumina-lang
+```
+
+## 🚀 Getting Started (Lumina)
+
+Lumina is a full toolchain: multi-file parsing, semantic checks, IR optimization, and codegen.
+
+## 🧪 Tests
+
+```bash
+npm test
+```
+
+## 🧰 CLI
+
+The package installs two binaries:
+- `lumina` for the Lumina toolchain (including grammar tooling)
+- `lumina-lsp` for editor integration
+
+### `lumina`
+
+```bash
+lumina repl
+lumina compile examples/hello.lm --out dist/hello.js --target esm
+lumina compile examples/hello.lm --sourcemap
+lumina compile examples/hello.lm --debug-ir
+lumina compile examples/hello.lm --profile-cache
+lumina check examples/hello.lm
+lumina watch examples
+lumina compile examples/hello.lm --dry-run
+lumina compile examples/hello.lm --recovery
+lumina compile --list-config
+lumina watch "examples/**/*.lm"
+lumina init
+lumina grammar mylang.peg --test "hello world"
+
+Parser generator tooling now lives under `lumina grammar`.
+
+`--profile-cache` also prints dependency graph stats.
+```
+
+### `lumina.config.json`
+
+You can configure defaults for the Lumina CLI:
+
+```json
+{
+  "grammarPath": "src/grammar/lumina.peg",
+  "outDir": "dist",
+  "target": "esm",
+  "entries": ["examples/hello.lm"],
+  "watch": ["examples/hello.lm"],
+  "fileExtensions": [".lm", ".lumina"],
+  "cacheDir": ".lumina-cache",
+  "recovery": true
+}
+```
+
+Schema: `lumina.config.schema.json`
+
+### REPL
+
+```bash
+npm run repl
+```
+
+Key commands:
+- `.grammar [inline|@file]`
+- `.test [inline]`
+- `.paste [--no-parse]`
+- `.ast on|off|json|tree`
+- `.stats`
+- `.profile [n]`
+- `.watch <file>`
+- `.session save|load <file>`
+
+## 🧭 Lumina LSP
+
+Run the server:
+
+```bash
+npx lumina-lsp
+```
+
+If built locally:
+
+```bash
+node dist/bin/lumina-lsp.js
+```
+
+### LSP Settings
+
+- `lumina.grammarPath`: path to the grammar (default `src/grammar/lumina.peg`)
+- `lumina.maxDiagnostics`: max diagnostics per file (default `200`)
+- `lumina.fileExtensions`: file extensions to watch (default `[".lum", ".lumina"]`)
+- `lumina.maxIndexFiles`: max files indexed per workspace (default `2000`)
+- `lumina.renameConflictMode`: conflict checks (`"all"` or `"exports"`, default `"all"`)
+- `lumina.renamePreviewMode`: rename preview output (`"popup"`, `"log"`, `"off"`, default `"popup"`)
+- `lumina.recovery`: enable resilient parsing for CLI `compile/check/watch` (default `false`)
+- Go-to-Definition, Find References, Rename, and Semantic Tokens
+
+Example (VS Code settings):
+
+```json
+{
+  "lumina.renamePreviewMode": "log",
+  "lumina.renameConflictMode": "all"
+}
+```
+
+## 🧭 Lumina By Example
+
+Create two files:
+
+`examples/types.lm`:
+
+```lumina
+import { io } from "@std";
+
+struct User { id: int, name: string }
+enum Result { Ok(int), Err(string) }
+
+fn main() {
+  let user: User = match Ok(1) {
+    Ok(value) => User,
+    Err(msg) => User,
+  };
+  return user.id;
+}
+```
+
+`examples/main.lm`:
+
+```lumina
+import { main } from "./types.lm";
+
+fn entry() {
+  return main();
+}
+```
+
+### Local Type Inference
+
+```lumina
+fn main() {
+  let x = 42;
+  let y: int = 10;
+  return x + y;
+}
+```
+
+Compile the project:
+
+```bash
+lumina compile examples/main.lm --out dist/main.js --target esm
+```
+
+### Dependency Graph + Resilient Parsing
+
+Lumina maintains a dependency graph for multi-file projects and uses panic-mode recovery so a single syntax error does not stop the entire analysis pass.
+
+## 🧪 REPL With Custom Grammar
+
+You can start the REPL and load a grammar file directly:
+
+```bash
+npm run repl
+```
+
+Inside the REPL:
+
+```text
+.grammar @examples/lumina.peg
+.test
+fn main() { return 1; }
+.end
+```
+
+## 🤝 Contributing / Development
+
+```bash
+npm install
+npm run build
+npm run lint:check
+npm test
+```
+
+## 📁 Project Layout
+
+- `src/grammar`: grammar compiler and bundled grammars
+- `src/parser`: parser utilities, streaming parse, diagnostics
+- `src/repl.ts`: REPL implementation
+- `src/lumina`: Lumina lexer, AST, semantic analysis, IR, codegen
+- `src/project`: multi-file project context + panic recovery
+- `src/lsp`: Lumina language server
+- `examples`: sample grammars and Lumina templates
+- `tests`: Jest test suite
+
+## 🛠️ Build
+
+```bash
+npm run build
+```
+
+## 📦 Packaging Check
+
+Before publishing, run:
+
+```bash
+npm run pack:check
+```
+
+## 📜 License
+
+MIT

package/RELEASE.md

@@ -0,0 +1,8 @@
+# Release Process
+
+1. Update `CHANGELOG.md`.
+2. Bump version in `package.json`.
+3. Run `npm test` and `npm run build`.
+4. Run `npm run pack:check`.
+5. Tag the release: `git tag vX.Y.Z` and `git push origin vX.Y.Z`.
+6. Publish: `npm publish`.