@miliastry/quasar 1.0.0

package/LICENSE

@@ -0,0 +1,119 @@
+MILIASTRY SOURCE LICENSE
+Version 1.0 (MSL-1.0)
+
+Copyright (c) 2026 hxovc / Miliastry Team
+
+This license governs use of the software accompanying this license.
+By using the software, you agree to the terms of this license.
+
+1. DEFINITIONS
+
+"Software" means the source code and other materials distributed under
+this license.
+
+"Miliastry Nova" means the Miliastry Nova product, including its
+integrated visual editing environment, user interface, workspace
+architecture, and associated visual authoring capabilities, as
+distributed by the copyright holder.
+
+"Competing Product" means a software product or service whose primary
+purpose is to compete directly with Miliastry Nova as an integrated
+visual BBCode authoring environment or IDE, or to compete directly
+with the Software itself.
+
+A product is not a Competing Product merely because it:
+
+(a) uses, depends upon, or incorporates the Software;
+
+(b) provides BBCode editing capabilities;
+
+(c) provides visual BBCode editing capabilities;
+
+(d) provides tools for osu! profile creation or customization; or
+
+(e) provides functionality that is technically similar to an individual
+feature of Miliastry Nova.
+
+The determination of whether a product is a Competing Product shall be
+based on the product as a whole, including its primary purpose,
+positioning, and intended use, rather than on the presence of individual
+features.
+
+2. COPYRIGHT GRANT
+
+Subject to the terms and limitations of this license, each contributor
+grants you a perpetual, worldwide, non-exclusive, royalty-free license
+to reproduce, modify, create derivative works from, and distribute the
+Software and such derivative works.
+
+3. PATENT GRANT
+
+Each contributor grants you a worldwide, non-exclusive, royalty-free
+license under patent claims owned or controlled by that contributor
+that necessarily read on their contribution to make, use, sell, offer
+for sale, import, and otherwise distribute the Software.
+
+4. COMPETITION RESTRICTION
+
+During the Restricted Period, you may not use the Software, or a
+derivative work of the Software, as a substantial part of a Competing
+Product.
+
+This restriction applies only where the Software is used with the
+purpose of creating, operating, or providing a product that directly
+competes with Miliastry Nova.
+
+This restriction does not prohibit the creation, distribution, or use of
+general-purpose BBCode editors, osu! profile tools, BBCode libraries,
+renderers, parsers, visual editors, authoring tools, or other software
+that does not directly compete with Miliastry Nova or the Software itself.
+
+5. NO TRADEMARK RIGHTS
+
+This license does not grant permission to use the names, logos,
+trademarks, or other branding of Miliastry, Miliastry Nova, or any
+contributor.
+
+6. RESTRICTED PERIOD
+
+The restrictions in Section 4 apply for two (2) years beginning on the
+date on which the applicable version of the Software is first publicly
+released under this license.
+
+After the Restricted Period expires, the Software is automatically
+relicensed under the MIT License.
+
+7. CONTRIBUTIONS
+
+Each contributor grants its contribution under this license unless the
+contributor explicitly states otherwise.
+
+Contributors do not receive any rights to use the trademarks or branding
+of Miliastry.
+
+8. DISCLAIMER
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, AND
+NON-INFRINGEMENT.
+
+9. LIMITATION OF LIABILITY
+
+TO THE MAXIMUM EXTENT PERMITTED BY LAW, NO CONTRIBUTOR SHALL BE LIABLE
+FOR ANY CLAIM, DAMAGES, OR OTHER LIABILITY ARISING FROM THE USE OF THE
+SOFTWARE.
+
+10. TERMINATION
+
+If you violate the restrictions of this license, the rights granted to
+you under this license terminate automatically.
+
+Rights that have already permanently converted to the MIT License are
+not affected.
+
+11. GOVERNING INTERPRETATION
+
+This license shall be interpreted to preserve the broad permission to
+use the Software for purposes that do not directly compete with
+Miliastry Nova.

package/README.md

@@ -0,0 +1,45 @@
+<div align="center">
+  <h1>🌌 Quasar Document Engine</h1>
+  <p><strong>Compiler-grade AST infrastructure for real-time document editing.</strong></p>
+</div>
+
+---
+
+> Traditional BBCode or Markdown parsers rely on brittle Regex that destroy user formatting, collapse on invalid syntax, and freeze the UI on large documents. **Quasar is different.**
+
+Quasar is the official document engine powering **Miliastry Nova**. It brings the architectural patterns used by modern language compilers (like C#'s *Roslyn* and Apple's *SwiftSyntax*) directly into the browser and desktop using pure TypeScript.
+
+Instead of translating strings to HTML, Quasar builds a living, immutable **Red-Green Syntax Tree**. It parses documents incrementally in microseconds, guarantees perfect round-tripping (preserving every single space and newline), and allows for real-time visual editing at 140 FPS.
+
+## ✨ The Core Philosophy
+
+- 🌳 **Red-Green Syntax Tree**: An immutable, flyweight `GreenNode` core for structural sharing and memory deduplication, paired with a stateful `RedNode` facade for UI binding and cursor tracking.
+- ⚡ **Incremental Parsing**: When a user types a single character in a 50KB document, Quasar only re-parses the affected span. Average mutation latency: `< 0.15ms`.
+- 🛡️ **Error-Tolerant by Design**: The parser never crashes. Invalid syntax, unclosed tags, or malformed attributes simply produce `ErrorNodes` with diagnostics, keeping the rest of the AST intact.
+- 🔄 **Perfect Round-Tripping**: "Trivia" (spaces, newlines, raw formatting) is strictly preserved. What the user types is exactly what is saved.
+- 🔌 **Agnostic & Multi-Format**: While heavily optimized for BBCode, Quasar's Bridges support ingestion and emission of HTML, Markdown, and JSON ASTs.
+- 📦 **Zero Runtime Dependencies**: Pure TypeScript. Runs natively in the Browser, Node.js, Deno, Bun, or Tauri.
+
+## 🚀 Installation
+
+```bash
+npm install github:hxovc/Miliastry-Quasar#main
+```
+
+*(Note: Quasar is currently distributed as a git submodule for Miliastry Nova)*
+
+## 📚 Documentation & Architecture
+
+Quasar's internal architecture is highly advanced. If you want to understand how the parser pipeline works, how memory deduplication is achieved, or how to build AST transformers, start here:
+
+- [**Naked Architecture (QuasarArch.MD)**](./QuasarArch.MD): Deep forensic analysis of the internal architecture, parsing pipeline, and modules.
+- [**Roadmap (QuasarRoadmap.MD)**](./QuasarRoadmap.MD): Current and future state of the engine.
+- [**Collaboration (QuasarCollab.MD)**](./QuasarCollab.MD): Contribution guidelines.
+
+---
+
+## 📜 License
+
+[**Miliastry Source License (MSL-1.0)**](LICENSE) — Copyright (c) 2026 hxovc / Miliastry Team.
+
+Quasar is Source-Available under a custom license designed to protect the Miliastry ecosystem. You can use, modify, and distribute the engine for any project—including standard visual BBCode editors or osu! profile tools—**except** for creating a Competing Product (i.e., a direct clone of Miliastry Nova as an integrated IDE, or a competing standalone engine based on this code). The license automatically converts to a standard MIT License 2 years after each commit.