📚 Table of Contents

• Installation
• Usage
• Language Syntax
• CLI Reference
• Project Structure
• Developing
• Coming Soon
• License
• Credits

A domain-specific pirate-themed programming language that compiles .onepiece code to JavaScript.

Write code like a pirate. Sail through syntax. Claim your treasure. 🦜

📦 Installation

npm install -g onepiece-lang

This installs the onepiece CLI globally.

🚀 Usage

onepiece run <file.onepiece>

Compiles a .onepiece file into JavaScript (output.js by default).

Example

onepiece run examples.onepiece
node output.js

💬 Language Syntax

💡 Variable Declaration

temporaryBounty coins = 100     // let
permanentBounty name = "Luffy"  // const

💡 Conditionals

hasHaki (coins > 50)
  echoDenDen("You’re rich!")
noHaki
  echoDenDen("Not enough Berries.")
DockAtHarbor

💡 Functions

crewSkill cheer() {
  echoDenDen("I will become the Pirate King!")
}
cheer()

💡 Loops

sailThrough (let i = 0; i < 5; i++)
  echoDenDen(i)
DockAtHarbor

💡 While Loops

untilRaftel (health > 0)
  echoDenDen("Keep sailing!")
  health--
DockAtHarbor

💡 Return, Break

claimTreasure "One Piece is real!"   // return
abandonShip                          // break

📘 Core Keywords

| OnePiece Keyword | JavaScript Equivalent | | ----------------- | --------------------- | | temporaryBounty | let | | permanentBounty | const | | hasHaki | if | | noHaki | else | | DockAtHarbor | } (block end) | | crewSkill | function | | echoDenDen() | console.log() | | sailThrough | for loop | | untilRaftel | while loop | | claimTreasure | return | | abandonShip | break |

🧪 Sample Program

File: examples.onepiece

temporaryBounty bounty = 3000

hasHaki (bounty > 1000)
  echoDenDen("High bounty pirate!")
noHaki
  echoDenDen("Still a rookie.")
DockAtHarbor

crewSkill attack() {
  echoDenDen("Gomu Gomu no Pistol!")
}
attack()

Output: output.js

let bounty = 3000;

if (bounty > 1000) {
  console.log("High bounty pirate!");
} else {
  console.log("Still a rookie.");
}

function attack() {
  console.log("Gomu Gomu no Pistol!");
}
attack();

⚙️ CLI Reference

| Command | Description | | ------------------------ | ---------------------------------- | | onepiece run <file> | Compile .onepiece to output.js | | onepiece --help | Show usage/help menu | | onepiece --jolly-roger | Display themed ASCII banner |

🧩 Project Structure

.
├── examples.onepiece     // Pirate-style source code
├── output.js             // JS output
├── compiler.js           // Compiler runner
├── parser.js             // Translates lines to JS
├── lexer.js              // Tokenizer
├── phrases.js            // Keyword mappings
├── postinstall.js        // Installation banner
└── package.json          // CLI configuration

🛠️ Developing

To work locally on the compiler:

git clone https://github.com/deepaksarun/onepiece-lang.git
cd onepiece-lang
npm install
npm link     # For local CLI testing

Then run:

onepiece run examples.onepiece

✨ Coming Soon

• 🖊 Syntax highlighting for VS Code
• 🧪 REPL: onepiece shell
• 🌍 GitHub Pages documentation
• 📦 Playground: OnePieceLang Web Compiler

📜 License

MIT — Use across all Grand Line territories. 🌊

Credits & Disclaimer

OnePiece Lang is a fan-made tribute to the legendary anime and manga One Piece.
It is not affiliated with, endorsed by, or officially licensed by Eiichiro Oda, Toei Animation, Shueisha, or any other official rights holders.

• 🖊 Original Series by: Eiichiro Oda
• 🎥 Anime by: Toei Animation
• 📚 Manga Publisher: Shueisha, Weekly Shōnen Jump

All characters, settings, and themes are properties of their respective copyright holders.

This project exists solely for educational and entertainment purposes.
No commercial usage is intended.

🏴‍☠️ From one Straw Hat fan to another: May your code always find LaughTale!

👑 Created By

Deepak Sarun

🧭 "If (Exists): { I build }"

Follow the voyage: github.com/deepaksarun

---

## ☑️ What’s Next?

Would you like me to:

- Convert this to live GitHub Pages docs?
- Scaffold a `docs/` folder with markdown for each keyword?
- Create a PirateLang Playground UI (via React or Next.js)?
- Add JSDoc-style inline docs to your codebase?

You're building the pirate equivalent of Python, Captain. Let’s raise the sails 🚢