sommark 3.3.3 → 4.0.0

package/README.md

@@ -1,118 +1,134 @@
-<img width="2000" height="491" alt="SomMark Cover" src="https://raw.githubusercontent.com/Adam-Elmi/SomMark/master/assets/smark_bg.png" />
+# SomMark v4 <img src="assets/smark.logo.png" width="80" align="right">
 
-<p align="center">
-SomMark v3 is a simple, flexible markup language for structured content.
-</p>
+[![npm version](https://img.shields.io/npm/v/sommark.svg)](https://www.npmjs.com/package/sommark)
+[![license](https://img.shields.io/npm/l/sommark.svg)](https://github.com/Adam-Elmi/SomMark/blob/master/LICENSE)
 
-<p align="center">
-<!--License-->
-<a href="https://www.npmjs.com/package/sommark" target="_blank">
-<img src="https://img.shields.io/badge/license-MIT-green?style=flat-square" />
-</a>
+SomMark is a high-performance markup language designed for structured content. It acts as an extensible source language that can be transformed into multiple formats like HTML, JSON, MDX, XML, and Markdown.
 
-<!--Npm Version-->
-<a href="https://www.npmjs.com/package/sommark" target="_blank">
-<img src="https://img.shields.io/npm/v/sommark?style=flat-square" />
-</a>
+SomMark uses explicit structural boundaries to ensure your document remains stable and predictable. It enables infinite nesting and provides total control over your contents.
 
-<!--Language Type-->
-<img src="https://img.shields.io/badge/type-markup%20language-orange?style=flat-square" />
+---
 
-<!--SomMark Playground-->
-<a href="https://adam-elmi.github.io/SomMark-Playground" target="_blank">
-<img 
-src="https://img.shields.io/badge/SomMark-Playground-blue?style=flat-square" 
-alt="SomMark Playground Badge" />
-</a>
-</p>
+## Simple Showcase
 
-----
+SomMark uses blocks for structure. A block starts with `[identifier]` and must end with `[end]`.
 
-## Try SomMark Playground
+### HTML
+```ini
+[h1]Welcome to SomMark[end]
+
+[div = class: "main"]
+  This is content inside a container block.
+  [p]
+    Blocks are the most important part of SomMark.
+    (This is a span-like inline statement)->(css: "color: green")
+  [end]
+[end]
+```
 
-Test SomMark live in your browser:  
-[https://adam-elmi.github.io/SomMark-Playground/](https://adam-elmi.github.io/SomMark-Playground/)
+### JSON
+SomMark can represent complex data structures through its specialized mappers.
+```ini
+[object]
+  [string = key: "name"]Adam Elmi[end]
+  [number = key: "age"]25[end]
+  [array = key: "skills"]
+    [string]JavaScript[end]
+    [string]SomMark[end]
+  [end]
+[end]
+```
 
-----
+### XML
+SomMark produces clean, structured XML ideal for configuration and data manifests.
+```ini
+[xml = version: "1.0"][end]
+[project = name: "SomMark-App"]
+  [metadata]
+    [author]Adam Elmi[end]
+    [version]4.0.0[end]
+  [end]
+  [settings]
+    [database = type: "postgres"]
+      [host]localhost[end]
+      [port]5432[end]
+    [end]
+  [end]
+[end]
+```
 
-# What's new in v3?
+### MDX
+Use the JavaScript data layer to pass native data to your components.
+```ini
+[h1]MDX Portfolio[end]
 
-SomMark v3 is faster, more powerful, and easier to extend.
+[Gallery = 
+  images: js{["nature.jpg", "tech.jpg"]}, 
+  active: js{true}
+]
+  This block uses native JS arrays and booleans.
+[end]
+```
 
-- **HTML Support**: Full HTML5 Support
-- **Markdown Support**: Full Markdown Support
-- **JSON Support**: Full JSON Support
-- **MDX Support**: Full MDX Support
-- **Plugin System**: Add new features without changing the core code.
-- **Modular Support**: Easily import files and use variables.
-- **Type-Safe Rules**: Set requirements for tags and attributes.
-- **Clean Syntax**: Simplified block, atblock & inline rules and better error handling.
+### Markdown
+Use placeholders to inject dynamic text into your templates.
+```ini
+[h1]Hello p{username}[end]
 
-# Installation
+[quote]
+  You are reading documentation on p{siteName}.
+  SomMark is an extensible language.
+[end]
 
-```bash
-npm install -g sommark
+[hr][end]
 ```
 
-# Usage
+---
 
-## v3 Syntax Example
+## How It Works
 
-SomMark is designed to be readable and clear.
+SomMark is an extensible language that processes content through a four-stage pipeline:
 
-```ini
-# Html
-[h1]Welcome to SomMark v3[end]
+1.  **Lexing**: The engine scans the source and converts it into a stream of tokens.
+2.  **Parsing**: Tokens are organized into a hierarchical tree called an **AST** (Abstract Syntax Tree).
+3.  **Mapping**: This is the translation layer. You define how identifiers (like `[h1]`) look in the target language.
+4.  **Transpilation**: The engine walks the AST and uses the Mapper to generate the final string output.
 
-[section = class: "hero", id: "main"]
-  [a = href: "https://sommark.org"]Visit Website[end]
-[end]
+The **Module System** enables a "Declare-then-Inject" pattern, allowing you to import mappers and create scalable projects with full recursive support.
 
-# Markdown
-[quote]
-SomMark is simple and powerful.
-[end]
+---
 
-[bold]Check out our syntax guide![end]
+## Installation
 
-# Json
-[Json= object]
-[Object = "user"]
-  (name)->(string: "Adam Elmi")
-  (age)->(number: 25)
-  (is_active_user)->(bool: true)
-[end]
-[end]
+Install the SomMark CLI globally:
+
+```bash
+npm install -g sommark
 ```
 
-## Using in JavaScript
+---
+
+## Usage in Node.js
 
 ```javascript
 import SomMark from "sommark";
 
-const smark = new SomMark({
-	src: '[h1]Hello World[end]',
-	format: "html"
+const sm = new SomMark({
+  src: "[h1]Hello World[end]",
+  format: "html"
 });
 
-console.log(await smark.transpile());
+const output = await sm.transpile();
+// <h1>Hello World</h1>
 ```
 
-# Documentation
-
-Read our detailed guides in the `docs/` folder:
-
-- **[Syntax Guide](docs/03.syntax.md)**: How to write SomMark (Blocks, Inline, At-Blocks).
-- **[Plugin System](docs/19.plugin-system.md)**: How to create your own plugins.
-- **[Built-in Plugins](docs/20.built-in-plugins.md)**: Guide to standard plugins.
-- **[Core API](docs/09.core.md)**: How to use SomMark in your code.
-- **[Mapper API](docs/13.mapper.md)**: How to create new output formats.
-- **[CLI Reference](docs/11.cli.md)**: Terminal commands and flags.
-- **[API Quick Reference](docs/api)**: Fast lookup for all functions.
+---
 
-# Editor Support
+## Documentation
 
-### Editor Support
-High-quality syntax highlighting and diagnostics are provided via **LSP Semantic Tokens**. This ensures perfect coloring in any editor that supports the Language Server Protocol (e.g., VS Code, Neovim, CoC).
+Read the full guides in the `docs/` folder:
 
-Information for integration can be found in the [SomMark-LSP](https://github.com/Adam-Elmi/SomMark-LSP) project.
+*   **[Syntax Guide](docs/syntax/syntax.md)**: Rules for writing Blocks, At-Blocks, and Inlines.
+*   **[Core Logic](docs/core/core.md)**: Deep dive into the engine architecture.
+*   **[Mapper API](docs/core/mapper.md)**: How to create your own translation layers.
+*   **[Module System](docs/core/module-system.md)**: Managing multi-file projects.

package/assets/logo.json

@@ -0,0 +1,28 @@
+{
+	"letter": {
+		"font": "jaro",
+		"color": "#FFFFFF",
+		"stroke-color": "#110B52",
+		"stroke-transparent": "13%"
+	},
+	"background": {
+		"colors": {
+			"color-1": {
+				"color": "#F80753",
+				"gradient-stop-position": "0%",
+				"transparent": "100%"
+			},
+			"color-2": {
+				"color": "#920431",
+				"gradient-stop-position": "100%",
+				"transparent": "100%"
+			}
+		}
+	},
+	"arrow": {
+		"font": "Karantina",
+		"color": "#FFFFFF",
+		"stroke-color": "#585394",
+		"stroke-transparent": "26%"
+	}
+}

package/assets/smark.logo.svg

@@ -0,0 +1,21 @@
+<svg width="60" height="66" viewBox="0 0 60 66" fill="none" xmlns="http://www.w3.org/2000/svg">
+<rect y="1" width="60" height="60" rx="5" fill="url(#paint0_linear_103_13)"/>
+<mask id="path-2-outside-1_103_13" maskUnits="userSpaceOnUse" x="8" y="15" width="17" height="34" fill="black">
+<rect fill="white" x="8" y="15" width="17" height="34"/>
+<path d="M9.76 48C9.36 48 9.16 47.8 9.16 47.4V42.888C9.16 42.68 9.168 42.512 9.184 42.384C9.216 42.256 9.312 42.152 9.472 42.072L15.76 39.192V34.92L9.568 31.08C9.296 30.92 9.16 30.68 9.16 30.36V21.552C9.16 21.296 9.176 21.112 9.208 21C9.24 20.872 9.36 20.736 9.568 20.592L15.88 16.32C16.04 16.224 16.184 16.152 16.312 16.104C16.456 16.04 16.632 16.008 16.84 16.008H23.32C23.72 16.008 23.92 16.208 23.92 16.608V20.688C23.92 21.04 23.8 21.28 23.56 21.408L17.272 24V28.44L23.56 32.04C23.8 32.152 23.92 32.408 23.92 32.808V43.248C23.92 43.376 23.896 43.512 23.848 43.656C23.816 43.8 23.736 43.904 23.608 43.968L16.072 47.712C15.976 47.76 15.856 47.824 15.712 47.904C15.584 47.968 15.456 48 15.328 48H9.76Z"/>
+</mask>
+<path d="M9.76 48C9.36 48 9.16 47.8 9.16 47.4V42.888C9.16 42.68 9.168 42.512 9.184 42.384C9.216 42.256 9.312 42.152 9.472 42.072L15.76 39.192V34.92L9.568 31.08C9.296 30.92 9.16 30.68 9.16 30.36V21.552C9.16 21.296 9.176 21.112 9.208 21C9.24 20.872 9.36 20.736 9.568 20.592L15.88 16.32C16.04 16.224 16.184 16.152 16.312 16.104C16.456 16.04 16.632 16.008 16.84 16.008H23.32C23.72 16.008 23.92 16.208 23.92 16.608V20.688C23.92 21.04 23.8 21.28 23.56 21.408L17.272 24V28.44L23.56 32.04C23.8 32.152 23.92 32.408 23.92 32.808V43.248C23.92 43.376 23.896 43.512 23.848 43.656C23.816 43.8 23.736 43.904 23.608 43.968L16.072 47.712C15.976 47.76 15.856 47.824 15.712 47.904C15.584 47.968 15.456 48 15.328 48H9.76Z" fill="#F5F5F5"/>
+<path d="M9.184 42.384L8.21386 42.1415L8.19921 42.2L8.19172 42.26L9.184 42.384ZM9.472 42.072L9.05558 41.1628L9.04006 41.1699L9.02479 41.1776L9.472 42.072ZM15.76 39.192L16.1764 40.1012L16.76 39.8339V39.192H15.76ZM15.76 34.92H16.76V34.3635L16.287 34.0702L15.76 34.92ZM9.568 31.08L10.095 30.2302L10.0851 30.224L10.075 30.2181L9.568 31.08ZM9.208 21L10.1695 21.2747L10.1741 21.2587L10.1781 21.2425L9.208 21ZM9.568 20.592L9.00747 19.7638L8.99879 19.7698L9.568 20.592ZM15.88 16.32L15.3655 15.4625L15.3421 15.4765L15.3195 15.4918L15.88 16.32ZM16.312 16.104L16.6631 17.0403L16.691 17.0299L16.7181 17.0178L16.312 16.104ZM23.56 21.408L23.9411 22.3325L23.9869 22.3137L24.0306 22.2904L23.56 21.408ZM17.272 24L16.8909 23.0755L16.272 23.3306V24H17.272ZM17.272 28.44H16.272V29.0198L16.7751 29.3078L17.272 28.44ZM23.56 32.04L23.0631 32.9078L23.0993 32.9286L23.1371 32.9462L23.56 32.04ZM23.848 43.656L22.8993 43.3398L22.883 43.3887L22.8718 43.4391L23.848 43.656ZM23.608 43.968L24.0529 44.8636L24.0552 44.8624L23.608 43.968ZM16.072 47.712L15.6271 46.8164L15.6248 46.8176L16.072 47.712ZM15.712 47.904L16.1592 48.7984L16.1786 48.7887L16.1976 48.7782L15.712 47.904ZM9.76 48V47C9.71414 47 9.86343 46.9892 10.0171 47.1429C10.1708 47.2966 10.16 47.4459 10.16 47.4H9.16H8.16C8.16 47.7541 8.24921 48.2034 8.60289 48.5571C8.95657 48.9108 9.40586 49 9.76 49V48ZM9.16 47.4H10.16V42.888H9.16H8.16V47.4H9.16ZM9.16 42.888H10.16C10.16 42.6997 10.1676 42.5778 10.1763 42.508L9.184 42.384L8.19172 42.26C8.16844 42.4462 8.16 42.6603 8.16 42.888H9.16ZM9.184 42.384L10.1541 42.6265C10.1265 42.737 10.072 42.8263 10.0148 42.8883C9.96234 42.9451 9.92001 42.966 9.91921 42.9664L9.472 42.072L9.02479 41.1776C8.70151 41.3392 8.33947 41.639 8.21386 42.1415L9.184 42.384ZM9.472 42.072L9.88842 42.9812L16.1764 40.1012L15.76 39.192L15.3436 38.2828L9.05558 41.1628L9.472 42.072ZM15.76 39.192H16.76V34.92H15.76H14.76V39.192H15.76ZM15.76 34.92L16.287 34.0702L10.095 30.2302L9.568 31.08L9.04097 31.9298L15.233 35.7698L15.76 34.92ZM9.568 31.08L10.075 30.2181C10.0699 30.2151 10.0768 30.2184 10.0896 30.2309C10.1029 30.244 10.1184 30.2629 10.132 30.287C10.162 30.3399 10.16 30.3751 10.16 30.36H9.16H8.16C8.16 31.0282 8.47828 31.5992 9.06098 31.9419L9.568 31.08ZM9.16 30.36H10.16V21.552H9.16H8.16V30.36H9.16ZM9.16 21.552H10.16C10.16 21.4428 10.1635 21.3632 10.1682 21.3086C10.1735 21.248 10.1782 21.2444 10.1695 21.2747L9.208 21L8.24648 20.7253C8.1732 20.9817 8.16 21.2868 8.16 21.552H9.16ZM9.208 21L10.1781 21.2425C10.1435 21.381 10.0801 21.4542 10.0718 21.4636C10.062 21.4748 10.0757 21.4568 10.1372 21.4142L9.568 20.592L8.99879 19.7698C8.75056 19.9417 8.36299 20.2569 8.23786 20.7575L9.208 21ZM9.568 20.592L10.1285 21.4202L16.4405 17.1482L15.88 16.32L15.3195 15.4918L9.0075 19.7638L9.568 20.592ZM15.88 16.32L16.3945 17.1775C16.5199 17.1022 16.6081 17.061 16.6631 17.0403L16.312 16.104L15.9609 15.1677C15.7599 15.243 15.5601 15.3458 15.3655 15.4625L15.88 16.32ZM16.312 16.104L16.7181 17.0178C16.7004 17.0257 16.7293 17.008 16.84 17.008V16.008V15.008C16.5347 15.008 16.2116 15.0543 15.9059 15.1902L16.312 16.104ZM16.84 16.008V17.008H23.32V16.008V15.008H16.84V16.008ZM23.32 16.008V17.008C23.3659 17.008 23.2166 17.0188 23.0629 16.8651C22.9092 16.7114 22.92 16.5621 22.92 16.608H23.92H24.92C24.92 16.2539 24.8308 15.8046 24.4771 15.4509C24.1234 15.0972 23.6741 15.008 23.32 15.008V16.008ZM23.92 16.608H22.92V20.688H23.92H24.92V16.608H23.92ZM23.92 20.688H22.92C22.92 20.7553 22.908 20.74 22.9356 20.6848C22.95 20.6559 22.972 20.623 23.0027 20.5917C23.0332 20.5605 23.0642 20.5391 23.0894 20.5256L23.56 21.408L24.0306 22.2904C24.6949 21.936 24.92 21.2824 24.92 20.688H23.92ZM23.56 21.408L23.1789 20.4835L16.8909 23.0755L17.272 24L17.6531 24.9245L23.9411 22.3325L23.56 21.408ZM17.272 24H16.272V28.44H17.272H18.272V24H17.272ZM17.272 28.44L16.7751 29.3078L23.0631 32.9078L23.56 32.04L24.0569 31.1722L17.7689 27.5722L17.272 28.44ZM23.56 32.04L23.1371 32.9462C23.0914 32.9248 23.0442 32.8927 23.0027 32.8503C22.9618 32.8085 22.9375 32.7681 22.9245 32.7404C22.902 32.6924 22.92 32.698 22.92 32.808H23.92H24.92C24.92 32.243 24.7403 31.4873 23.9829 31.1338L23.56 32.04ZM23.92 32.808H22.92V43.248H23.92H24.92V32.808H23.92ZM23.92 43.248H22.92C22.92 43.2507 22.9195 43.2793 22.8993 43.3398L23.848 43.656L24.7967 43.9722C24.8725 43.7447 24.92 43.5013 24.92 43.248H23.92ZM23.848 43.656L22.8718 43.4391C22.8836 43.3861 22.9117 43.3099 22.9714 43.2323C23.0316 43.1539 23.1021 43.1029 23.1608 43.0736L23.608 43.968L24.0552 44.8624C24.462 44.659 24.7292 44.3004 24.8242 43.8729L23.848 43.656ZM23.608 43.968L23.1631 43.0724L15.6271 46.8164L16.072 47.712L16.5169 48.6076L24.0529 44.8636L23.608 43.968ZM16.072 47.712L15.6248 46.8176C15.5109 46.8745 15.3771 46.9461 15.2264 47.0298L15.712 47.904L16.1976 48.7782C16.3349 48.7019 16.4411 48.6455 16.5192 48.6064L16.072 47.712ZM15.712 47.904L15.2648 47.0096C15.2606 47.0117 15.265 47.009 15.2775 47.0059C15.2903 47.0026 15.3078 47 15.328 47V48V49C15.6288 49 15.9089 48.9236 16.1592 48.7984L15.712 47.904ZM15.328 48V47H9.76V48V49H15.328V48Z" fill="#110B52" fill-opacity="0.13" mask="url(#path-2-outside-1_103_13)"/>
+<mask id="path-4-outside-2_103_13" maskUnits="userSpaceOnUse" x="30" y="25" width="26" height="23" fill="black">
+<rect fill="white" x="30" y="25" width="26" height="23"/>
+<path d="M40.048 42.944L43.312 39.68H31.28V33.728H43.248L40.048 30.528L43.76 26.88L53.616 36.736L43.76 46.592L40.048 42.944Z"/>
+</mask>
+<path d="M40.048 42.944L43.312 39.68H31.28V33.728H43.248L40.048 30.528L43.76 26.88L53.616 36.736L43.76 46.592L40.048 42.944Z" fill="#F5F5F5"/>
+<path d="M40.048 42.944L39.3409 42.2369L38.6276 42.9502L39.3471 43.6572L40.048 42.944ZM43.312 39.68L44.0191 40.3871L45.7262 38.68H43.312V39.68ZM31.28 39.68H30.28V40.68H31.28V39.68ZM31.28 33.728V32.728H30.28V33.728H31.28ZM43.248 33.728V34.728H45.6622L43.9551 33.0209L43.248 33.728ZM40.048 30.528L39.3471 29.8148L38.6276 30.5218L39.3409 31.2351L40.048 30.528ZM43.76 26.88L44.4671 26.1729L43.7661 25.4719L43.0591 26.1668L43.76 26.88ZM53.616 36.736L54.3231 37.4431L55.0302 36.736L54.3231 36.0289L53.616 36.736ZM43.76 46.592L43.0591 47.3052L43.7661 48.0001L44.4671 47.2991L43.76 46.592ZM40.048 42.944L40.7551 43.6511L44.0191 40.3871L43.312 39.68L42.6049 38.9729L39.3409 42.2369L40.048 42.944ZM43.312 39.68V38.68H31.28V39.68V40.68H43.312V39.68ZM31.28 39.68H32.28V33.728H31.28H30.28V39.68H31.28ZM31.28 33.728V34.728H43.248V33.728V32.728H31.28V33.728ZM43.248 33.728L43.9551 33.0209L40.7551 29.8209L40.048 30.528L39.3409 31.2351L42.5409 34.4351L43.248 33.728ZM40.048 30.528L40.7489 31.2412L44.4609 27.5932L43.76 26.88L43.0591 26.1668L39.3471 29.8148L40.048 30.528ZM43.76 26.88L43.0529 27.5871L52.9089 37.4431L53.616 36.736L54.3231 36.0289L44.4671 26.1729L43.76 26.88ZM53.616 36.736L52.9089 36.0289L43.0529 45.8849L43.76 46.592L44.4671 47.2991L54.3231 37.4431L53.616 36.736ZM43.76 46.592L44.4609 45.8788L40.7489 42.2308L40.048 42.944L39.3471 43.6572L43.0591 47.3052L43.76 46.592Z" fill="#585394" fill-opacity="0.26" mask="url(#path-4-outside-2_103_13)"/>
+<defs>
+<linearGradient id="paint0_linear_103_13" x1="30" y1="1" x2="30" y2="61" gradientUnits="userSpaceOnUse">
+<stop stop-color="#F80753"/>
+<stop offset="1" stop-color="#920431"/>
+</linearGradient>
+</defs>
+</svg>

package/cli/cli.mjs

@@ -1,5 +1,10 @@
 #!/usr/bin/env node
+/**
+ * SomMark CLI Entry Point
+ * Reads your command-line arguments and runs the right tool.
+ */
 import { enableColor } from "../helpers/colorize.js";
+
 import { getHelp } from "./commands/help.js";
 import { printVersion, printHeader } from "./commands/version.js";
 import { runBuild } from "./commands/build.js";
@@ -46,12 +51,14 @@ async function main() {
 		return;
 	}
 
-	// 4. Init
+	// 4. Init (Always Local)
 	if (command === "init") {
 		await runInit();
 		return;
 	}
 
+
+
 	// 5. Show
 	if (command === "show") {
 		await runShow(args[1]);
@@ -64,16 +71,6 @@ async function main() {
 		return;
 	}
 	
-	// 5.6. List
-	if (command === "list") {
-		const { runListPlugins, runListPipeline } = await import("./commands/list.js");
-		if (args[1] === "pipeline") {
-			await runListPipeline();
-		} else {
-			await runListPlugins(args.slice(1));
-		}
-		return;
-	}
 
 	// 6. Lex
 	if (command === "--lex") {
@@ -94,14 +91,9 @@ async function main() {
 	if (extensions[format]) {
 		// Build or Print
 		if (args[1] === "-p" || args[1] === "--print") {
-			// smark --format -p file
-			// args[0]=--format, args[1]=-p, args[2]=file
 			await printOutput(format, args[2]);
 			process.exit(0);
 		} else {
-			// smark --format file [options]
-			// args[0]=--format, args[1]=file, args[2]=-o, args[3]=output...
-
 			await runBuild(
 				command,      // format_option (--markdown)
 				args[1],      // sourcePath

package/cli/commands/build.js

@@ -5,6 +5,7 @@ import HTML from "../../mappers/languages/html.js";
 import MARKDOWN from "../../mappers/languages/markdown.js";
 import MDX from "../../mappers/languages/mdx.js";
 import Json from "../../mappers/languages/json.js";
+import XML from "../../mappers/languages/xml.js";
 import { extensions } from "../constants.js";
 import { isExist, readContent, createFile } from "../helpers/file.js";
 import { loadConfig } from "../helpers/config.js";
@@ -13,11 +14,20 @@ import { transpile } from "../helpers/transpile.js";
 // ========================================================================== //
 //  Generate Output File                                                      //
 // ========================================================================== //
-async function generateOutput(outputDir, outputFile, format, sourcePath, mappingFile) {
+/**
+ * Helper to generate and save the created code.
+ * @param {string} outputDir - Directory to save the file.
+ * @param {string} outputFile - Output filename (without extension).
+ * @param {string} format - Target format (html, markdown, etc.).
+ * @param {string} sourcePath - Path to the source .smark file.
+ * @param {Mapper|null} mappingFile - Custom mapped rules.
+ * @returns {Promise<string>} - The full path to the created file.
+ */
+async function generateOutput(outputDir, outputFile, format, sourcePath, mappingFile, config) {
     let source_code = await readContent(sourcePath);
     source_code = source_code.toString();
     const absolutePath = path.resolve(process.cwd(), sourcePath);
-    const output = await transpile({ src: source_code, format, filename: absolutePath, mappingFile });
+    const output = await transpile({ src: source_code, format, filename: absolutePath, mappingFile, config });
     const finalPath = path.join(outputDir, `${outputFile}.${extensions[format]}`);
     await createFile(outputDir, `${outputFile}.${extensions[format]}`, output);
     return finalPath;
@@ -26,6 +36,16 @@ async function generateOutput(outputDir, outputFile, format, sourcePath, mapping
 // ========================================================================== //
 //  Run Build Process                                                         //
 // ========================================================================== //
+/**
+ * The starting point for the build process.
+ * Checks the file type, loads settings, and creates the output code.
+ * 
+ * @param {string} format_option - The file format to output (like '--html').
+ * @param {string} sourcePath - The path to the file you want to build.
+ * @param {string} outputFlag - The '-o' flag.
+ * @param {string} outputFileArg - The custom filename.
+ * @param {string} outputDirArg - The custom directory.
+ */
 export async function runBuild(format_option, sourcePath, outputFlag, outputFileArg, outputDirArg) {
     try {
         const format = format_option.replaceAll("-", "") ?? "";
@@ -58,7 +78,7 @@ export async function runBuild(format_option, sourcePath, outputFlag, outputFile
                 let mappingFile = config.mappingFile;
 
                 if (!mappingFile) {
-                    mappingFile = format === "html" ? HTML : format === "markdown" ? MARKDOWN : format === "mdx" ? MDX : format === "json" ? Json : null;
+                    mappingFile = format === "html" ? HTML : format === "markdown" ? MARKDOWN : format === "mdx" ? MDX : format === "json" ? Json : format === "xml" ? XML : null;
                 }
 
                 // CLI Overrides
@@ -69,7 +89,7 @@ export async function runBuild(format_option, sourcePath, outputFlag, outputFile
                     }
                 }
 
-                const createdFilePath = await generateOutput(finalOutputDir, finalOutputFile, format, sourcePath, mappingFile);
+                const createdFilePath = await generateOutput(finalOutputDir, finalOutputFile, format, sourcePath, mappingFile, config);
                 const stats = await fs.stat(createdFilePath);
                 const date = new Date().toLocaleString();
 

package/cli/commands/color.js

@@ -1,36 +1,32 @@
-import fs from "node:fs/promises";
-import path from "node:path";
-import { getConfigDir } from "./init.js";
-
-// ========================================================================== //
-//  Color Command                                                              //
-// ========================================================================== //
-
-const COLOR_FILE = "color.json";
-
-function getColorFilePath() {
-    return path.join(getConfigDir(), COLOR_FILE);
-}
+import { formatMessage } from "../../core/errors.js";
 
+/**
+ * Checks if colors are turned on in your settings.
+ * @returns {Promise<boolean>}
+ */
 export async function isColorEnabled() {
-    try {
-        const data = await fs.readFile(getColorFilePath(), "utf-8");
-        return JSON.parse(data).enabled === true;
-    } catch {
-        return false;
-    }
+    return process.env.SOMMARK_COLOR === "true";
 }
 
+/**
+ * Shows the user how to turn colors on or off.
+ * @param {string} action - 'on' or 'off'.
+ */
 export function runColor(action) {
     if (action === "on") {
-        fs.mkdir(getConfigDir(), { recursive: true })
-            .then(() => fs.writeFile(getColorFilePath(), JSON.stringify({ enabled: true }), "utf-8"))
-            .then(() => console.log("Colors enabled."));
+        console.log(formatMessage([
+            `{line}<$yellow:SomMark uses Environment Variables for colors:$>{line}`,
+            `<$blue:Set this in your current shell:$>`,
+            `  <$cyan:export SOMMARK_COLOR=true$>{line}`,
+            `<$blue:Add it to your .bashrc or .zshrc for permanent effect.$>{line}`
+        ].join("")));
     } else if (action === "off") {
-        fs.mkdir(getConfigDir(), { recursive: true })
-            .then(() => fs.writeFile(getColorFilePath(), JSON.stringify({ enabled: false }), "utf-8"))
-            .then(() => console.log("Colors disabled."));
+        console.log(formatMessage([
+            `{line}<$yellow:To disable colors, run:$>{line}`,
+            `  <$cyan:export SOMMARK_COLOR=false$>{line}`,
+            `<$blue:(Or remove the SOMMARK_COLOR variable from your shell config)$>{line}`
+        ].join("")));
     } else {
-        console.log("Usage: sommark color <on|off>");
+        console.log(formatMessage(`Usage: <$blue:sommark color on|off$>`));
     }
 }

package/cli/commands/help.js

@@ -5,6 +5,11 @@ import { options } from "../constants.js";
 //  Help Command                                                              //
 // ========================================================================== //
 
+/**
+ * Displays the CLI help message.
+ * @param {boolean} [unknown_option=true] - Whether to show the "Unrecognized option" prefix if an invalid flag is passed.
+ * @returns {string} - The formatted help message.
+ */
 export function getHelp(unknown_option = true) {
 	const msg = [
 		`${unknown_option && process.argv[2] ? `<$red:Unrecognized option$> <$blue: '${process.argv[2]}'$>` : ""}`,
@@ -13,32 +18,27 @@ export function getHelp(unknown_option = true) {
 		"{N}{N}<$yellow:Global Options:$>",
 		"{N}  <$green:-h, --help$>     <$cyan: Show help message$>",
 		"{N}  <$green:-v, --version$>  <$cyan: Show version information$>",
-		"{N}  <$green:init$>           <$cyan: Initialize global SomMark configuration directory$>",
+		"{N}  <$green:init$>           <$cyan: Initialize local SomMark configuration file (smark.config.js)$>",
 		"{N}  <$green:show config$>    <$cyan: Display the absolute paths to the active SomMark configuration files$>",
-		"{N}  <$green:color on|off$>   <$cyan: Enable or disable colored output$>",
-		"{N}  <$green:list plugins$>    <$cyan: List all enabled plugins with author and description$>",
-		"{N}  <$green:list -i plugins$> <$cyan: List only internal (built-in) plugins$>",
-		"{N}  <$green:list -e plugins$> <$cyan: List only external (user-defined) plugins$>",
-		"{N}  <$green:list pipeline$>   <$cyan: Show the execution order of all active plugin phases$>",
+		"{N}  <$green:color on|off$>   <$cyan: Help on enabling colors via Environment Variables$>",
 
 		"{N}{N}<$yellow:Transpilation Options:$>",
 		"{N}<$yellow:Usage:$> <$blue:sommark [option] [targetFile] [option] [outputFile] [outputDir]$>",
 		"{N}  <$green:--html$>         <$cyan: Transpile to HTML$>",
 		"{N}  <$green:--markdown$>     <$cyan: Transpile to Markdown$>",
 		"{N}  <$green:--mdx$>          <$cyan: Transpile to MDX$>",
-		"{N}  <$green:--json$>         <$cyan: Transpile to json$>",
+		"{N}  <$green:--json$>         <$cyan: Transpile to JSON$>",
 		"{N}  <$green:--text$>         <$cyan: Transpile to plain text$>",
 		"{N}  <$green:--lex$>          <$cyan: Print lexer tokens to console$>",
 		"{N}  <$green:--parse$>        <$cyan: Print parser AST to console$>",
 
-		"{N}{N}<$yellow:Output Options:$>",
+		"{N}{N}<$yellow:Output & Config Overrides:$>",
 		"{N}  <$green:-p, --print$>    <$cyan: Print output to console (stdout)$>",
 		"{N}  <$green:-o$>             <$cyan: Specify output filename (and optionally directory)$>",
 
 		"{N}{N}<$yellow:Examples:$>",
 		"{N}  <$magenta:1. Basic usage:$> <$blue:sommark --html input.smark$>",
-		"{N}  <$magenta:2. Print to console:$> <$blue:sommark --html -p input.smark$>",
-		"{N}  <$magenta:3. Custom output:$> <$blue:sommark --html input.smark -o myOutput ./dist/$>"
+		"{N}  <$magenta:2. Custom output:$> <$blue:sommark --html input.smark -o myOutput ./dist/$>"
 	].join("");
 	const help_msg = formatMessage(msg);
 

package/cli/commands/init.js

@@ -1,60 +1,37 @@
-import fs from "node:fs/promises";
 import path from "node:path";
-import os from "node:os";
 import { cliError, formatMessage } from "../../core/errors.js";
+import { isExist, createFile } from "../helpers/file.js";
 
 // ========================================================================== //
 //  Init Command                                                              //
 // ========================================================================== //
 
-export function getConfigDir() {
-    const homeDir = os.homedir();
-    if (process.platform === "win32") {
-        return path.join(process.env.APPDATA || path.join(homeDir, "AppData", "Roaming"), "sommark");
-    } else if (process.platform === "darwin") {
-        return path.join(homeDir, "Library", "Application Support", "sommark");
-    } else {
-        return path.join(process.env.XDG_CONFIG_HOME || path.join(homeDir, ".config"), "sommark");
-    }
-}
-
+/**
+ * Initializes a new SomMark configuration file (smark.config.js) in the current directory.
+ */
 export async function runInit() {
     try {
-        const configDir = getConfigDir();
+        const configDir = process.cwd();
         const configFilePath = path.join(configDir, "smark.config.js");
 
-        // ======================================================
-        // Create configuration directory
-        // ======================================================
-
-        await fs.mkdir(configDir, { recursive: true });
-
-        // ======================================================
-        // Default configuration content
-        // ======================================================
-
-        const defaultConfigContent = `export default {
-    outputDir: "",
-    outputFile: "output",
-    mappingFile: "",
-    plugins: [],
-    priority: [],
+        const defaultConfigContent = `/**
+ * SomMark Configuration File
+ * Generated by 'smark init'
+ */
+export default {
+    format: "html",           // Target output format (html, markdown, mdx, json, xml)
+    removeComments: true,    // Strip SomMark comments from the final output
+    customProps: [],         // Whitelisted HTML attributes (prevents CSS hijacking)
+    placeholders: {},        // Global p{key} variables for content injection
+    outputDir: "./",         // Where to save the transpiled files
+    outputFile: "output",    // Default output filename
 };
 `;
 
-        // ======================================================
-        // Check if config file already exists
-        // ======================================================
-
-        try {
-            await fs.access(configFilePath);
+        if (await isExist(configFilePath)) {
             console.log(formatMessage(`<$yellow:Configuration already exists at:$> <$cyan:${configFilePath}$>`));
-        } catch {
-            // ======================================================
-            // Create default config file if it doesn't exist
-            // ======================================================
-
-            await fs.writeFile(configFilePath, defaultConfigContent, "utf-8");
+        } else {
+            await createFile(configDir, "smark.config.js", defaultConfigContent);
             console.log(formatMessage(`<$green:Initialized SomMark configuration at:$> <$cyan:${configFilePath}$>`));
         }
     } catch (error) {