gglang 1.0.0 → 1.0.1

package/README.md

@@ -1,4 +1,4 @@
-<![CDATA[```
+```
    ██████╗  ██████╗ ██╗      █████╗ ███╗   ██╗ ██████╗
   ██╔════╝ ██╔════╝ ██║     ██╔══██╗████╗  ██║██╔════╝
   ██║  ███╗██║  ███╗██║     ███████║██╔██╗ ██║██║  ███╗
@@ -155,4 +155,3 @@ For the complete language reference, syntax guide, and example programs, see the
 ## 📄 License
 
 This project is licensed under the **MIT License** — do whatever you want with it. GG! 🎮
-]]>

package/docs/DOCUMENTATION.md

@@ -1,4 +1,4 @@
-<![CDATA[# 📖 GGLang — Complete Language Documentation
+# 📖 GGLang — Complete Language Documentation
 
 > **Version 1.0** · The Gaming-Themed Programming Language
 
@@ -901,4 +901,3 @@ adventure.gg
 ---
 
 *GG! 🎮 — Happy coding with GGLang!*
-]]>

package/examples/adventure.gg

@@ -0,0 +1,315 @@
+// ============================================================
+//  ⚔️  THE DUNGEON OF GLITCHES — A GGLang Mini Adventure  ⚔️
+// ============================================================
+// This program demonstrates most GGLang features:
+//   - equip / artifact (variables / constants)
+//   - skill / loot (functions / return)
+//   - quest / side_quest / retreat (if / else if / else)
+//   - grind / rage_quit / respawn (while / break / continue)
+//   - boss_fight / revive / glitch (try / catch / throw)
+//   - broadcast / interact (output / input)
+//   - victory / defeat / phantom (true / false / null)
+// ============================================================
+
+spawn {
+
+  // ── Constants: permanent game rules ──────────────────────
+  artifact maxHealth = 100;
+  artifact potionHeal = 25;
+  artifact critMultiplier = 2;
+
+  // ── Utility skills ──────────────────────────────────────
+
+  /*
+   * Clamp a value between a min and max.
+   * Used to keep health within valid bounds.
+   */
+  skill clamp(value, min, max) {
+    quest (value < min) {
+      loot min;
+    }
+    quest (value > max) {
+      loot max;
+    }
+    loot value;
+  }
+
+  /*
+   * Calculate damage dealt to an enemy.
+   * Every 3rd hit is a critical strike!
+   */
+  skill calculateDamage(baseDamage, hitCount) {
+    quest (hitCount % 3 == 0) {
+      broadcast("💥 CRITICAL HIT!");
+      loot baseDamage * critMultiplier;
+    }
+    loot baseDamage;
+  }
+
+  /*
+   * Display a health bar using emoji.
+   */
+  skill showHealthBar(name, current, max) {
+    equip percentage = (current * 100) / max;
+    equip bar = name + " HP: [";
+
+    equip filled = 0;
+    grind (filled < 10) {
+      quest (filled * 10 < percentage) {
+        bar = bar + "❤️";
+      } retreat {
+        bar = bar + "🖤";
+      }
+      filled = filled + 1;
+    }
+
+    bar = bar + "] " + current + "/" + max;
+    broadcast(bar);
+  }
+
+  // ── Character Creation ──────────────────────────────────
+
+  broadcast("╔══════════════════════════════════════╗");
+  broadcast("║   ⚔️  THE DUNGEON OF GLITCHES  ⚔️    ║");
+  broadcast("╠══════════════════════════════════════╣");
+  broadcast("║  A GGLang Mini Text Adventure        ║");
+  broadcast("╚══════════════════════════════════════╝");
+  broadcast("");
+
+  equip playerName = interact("🎮 Enter your character name: ");
+  broadcast("");
+  broadcast("Welcome, " + playerName + "! Your adventure begins...");
+  broadcast("");
+
+  // Choose a class — affects base damage
+  broadcast("Choose your class:");
+  broadcast("  1) 🗡️  Warrior  (base damage: 20)");
+  broadcast("  2) 🧙 Mage     (base damage: 15, bonus crit)");
+  broadcast("  3) 🏹 Ranger   (base damage: 18)");
+
+  equip classChoice = interact("Enter 1, 2, or 3: ");
+  equip baseDamage = 15;
+  equip className = "Adventurer";
+
+  quest (classChoice == "1") {
+    baseDamage = 20;
+    className = "Warrior";
+    broadcast("🗡️ You chose Warrior! Strength is your ally.");
+  } side_quest (classChoice == "2") {
+    baseDamage = 15;
+    className = "Mage";
+    broadcast("🧙 You chose Mage! Arcane power flows through you.");
+  } side_quest (classChoice == "3") {
+    baseDamage = 18;
+    className = "Ranger";
+    broadcast("🏹 You chose Ranger! Swift and precise.");
+  } retreat {
+    broadcast("🤷 Invalid choice. You're a confused peasant with a stick.");
+    baseDamage = 10;
+    className = "Peasant";
+  }
+
+  broadcast("");
+
+  // ── Player stats ────────────────────────────────────────
+  equip playerHealth = maxHealth;
+  equip potions = 3;
+  equip gold = 0;
+  equip enemiesSlain = 0;
+
+  // ── The Dungeon: a combat grind ─────────────────────────
+  broadcast("━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━");
+  broadcast("You descend into the Dungeon of Glitches...");
+  broadcast("━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━");
+  broadcast("");
+
+  // Enemy roster
+  equip enemyNames    = "Slime,Skeleton,Goblin,Dark Knight,Glitch Dragon";
+  equip enemyHealths  = "30,45,40,70,120";
+  equip enemyDamages  = "5,10,8,15,25";
+  equip enemyGold     = "10,20,15,50,200";
+
+  equip currentEnemy = 0;
+  equip totalEnemies = 5;
+  equip gameOver = defeat;
+
+  grind (currentEnemy < totalEnemies && gameOver == defeat) {
+
+    // ── Determine enemy stats ─────────────────────────────
+    // (Simulating array access with conditional lookup)
+    equip eName = "Unknown";
+    equip eHealth = 30;
+    equip eDamage = 5;
+    equip eGold = 10;
+
+    quest (currentEnemy == 0) {
+      eName = "🟢 Slime";
+      eHealth = 30;
+      eDamage = 5;
+      eGold = 10;
+    } side_quest (currentEnemy == 1) {
+      eName = "💀 Skeleton";
+      eHealth = 45;
+      eDamage = 10;
+      eGold = 20;
+    } side_quest (currentEnemy == 2) {
+      eName = "👺 Goblin";
+      eHealth = 40;
+      eDamage = 8;
+      eGold = 15;
+    } side_quest (currentEnemy == 3) {
+      eName = "🖤 Dark Knight";
+      eHealth = 70;
+      eDamage = 15;
+      eGold = 50;
+    } side_quest (currentEnemy == 4) {
+      eName = "🐉 Glitch Dragon";
+      eHealth = 120;
+      eDamage = 25;
+      eGold = 200;
+    }
+
+    broadcast("══════════════════════════════════════");
+    broadcast("⚔️  A wild " + eName + " appears!");
+    broadcast("══════════════════════════════════════");
+
+    equip hitCount = 0;
+
+    // ── Combat loop ───────────────────────────────────────
+    grind (eHealth > 0 && playerHealth > 0) {
+
+      broadcast("");
+      showHealthBar(playerName, playerHealth, maxHealth);
+      showHealthBar(eName, eHealth, eHealth + hitCount * 10);
+      broadcast("");
+
+      broadcast("What will you do?");
+      broadcast("  1) ⚔️  Attack");
+      broadcast("  2) 🧪 Use Potion (" + potions + " left)");
+      broadcast("  3) 🏃 Run Away");
+
+      equip action = interact("Choose action (1/2/3): ");
+
+      quest (action == "1") {
+        // ── Attack with error handling ────────────────────
+        boss_fight {
+          hitCount = hitCount + 1;
+          equip dmg = calculateDamage(baseDamage, hitCount);
+
+          // Mages get bonus on every 2nd hit
+          quest (className == "Mage" && hitCount % 2 == 0) {
+            dmg = dmg + 5;
+            broadcast("✨ Arcane bonus! +5 damage");
+          }
+
+          eHealth = eHealth - dmg;
+          broadcast("🗡️ You hit " + eName + " for " + dmg + " damage!");
+
+          quest (eHealth <= 0) {
+            broadcast("🎉 " + eName + " has been defeated!");
+            gold = gold + eGold;
+            enemiesSlain = enemiesSlain + 1;
+            broadcast("💰 You earned " + eGold + " gold! (Total: " + gold + ")");
+          } retreat {
+            // Enemy strikes back
+            equip enemyHit = eDamage;
+            playerHealth = playerHealth - enemyHit;
+            playerHealth = clamp(playerHealth, 0, maxHealth);
+            broadcast("🔥 " + eName + " hits you for " + enemyHit + " damage!");
+          }
+        } revive (err) {
+          broadcast("⚠️ A glitch occurred in combat: " + err);
+          broadcast("The matrix resets... you take 5 damage.");
+          playerHealth = playerHealth - 5;
+        }
+
+      } side_quest (action == "2") {
+        // ── Use potion ────────────────────────────────────
+        quest (potions > 0) {
+          potions = potions - 1;
+          equip oldHealth = playerHealth;
+          playerHealth = clamp(playerHealth + potionHeal, 0, maxHealth);
+          equip healed = playerHealth - oldHealth;
+          broadcast("🧪 You used a potion! Healed " + healed + " HP.");
+          broadcast("   Potions remaining: " + potions);
+
+          // Enemy still attacks while you heal!
+          playerHealth = playerHealth - eDamage;
+          playerHealth = clamp(playerHealth, 0, maxHealth);
+          broadcast("🔥 " + eName + " hits you while healing for " + eDamage + " damage!");
+        } retreat {
+          broadcast("❌ No potions left! You fumble around uselessly.");
+          // Wasted turn — enemy attacks
+          playerHealth = playerHealth - eDamage;
+          playerHealth = clamp(playerHealth, 0, maxHealth);
+          broadcast("🔥 " + eName + " punishes your mistake for " + eDamage + " damage!");
+        }
+
+      } side_quest (action == "3") {
+        // ── Run away ──────────────────────────────────────
+        broadcast("🏃 You flee from " + eName + "!");
+        broadcast("Cowardice has a price... -10 gold.");
+        quest (gold >= 10) {
+          gold = gold - 10;
+        } retreat {
+          gold = 0;
+        }
+        // Skip to next enemy (don't get loot)
+        respawn;
+
+      } retreat {
+        broadcast("🤔 Invalid action. You hesitate and the enemy strikes!");
+        playerHealth = playerHealth - eDamage;
+        playerHealth = clamp(playerHealth, 0, maxHealth);
+      }
+
+      // ── Check player death ──────────────────────────────
+      quest (playerHealth <= 0) {
+        broadcast("");
+        broadcast("💀 " + playerName + " has fallen in battle!");
+        broadcast("══════════════════════════════════════");
+        gameOver = victory;
+        rage_quit;
+      }
+    }
+
+    currentEnemy = currentEnemy + 1;
+  }
+
+  // ── Game Over / Victory Screen ──────────────────────────
+  broadcast("");
+  broadcast("━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━");
+
+  quest (gameOver == victory) {
+    // Player died
+    broadcast("     💀 GAME OVER 💀");
+    broadcast("");
+    broadcast("  " + playerName + " the " + className);
+    broadcast("  fell in the dungeon.");
+    broadcast("  Enemies slain: " + enemiesSlain);
+    broadcast("  Gold collected: " + gold);
+  } retreat {
+    // Player survived all enemies!
+    broadcast("     🏆 VICTORY! 🏆");
+    broadcast("");
+    broadcast("  " + playerName + " the " + className);
+    broadcast("  conquered the Dungeon of Glitches!");
+    broadcast("  Enemies slain: " + enemiesSlain);
+    broadcast("  Gold collected: " + gold);
+    broadcast("  Health remaining: " + playerHealth + "/" + maxHealth);
+
+    quest (potions > 0) {
+      broadcast("  Unused potions: " + potions);
+    }
+
+    quest (playerHealth == maxHealth) {
+      broadcast("");
+      broadcast("  🌟 PERFECT RUN — Not a scratch! 🌟");
+    }
+  }
+
+  broadcast("━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━");
+  broadcast("");
+  broadcast("Thanks for playing The Dungeon of Glitches!");
+  broadcast("GG! 🎮");
+}

package/examples/fibonacci.gg

@@ -0,0 +1,14 @@
+spawn {
+  skill fibonacci(n) {
+    quest (n <= 1) {
+      loot n;
+    }
+    loot fibonacci(n - 1) + fibonacci(n - 2);
+  }
+
+  equip i = 0;
+  grind (i <= 15) {
+    broadcast("fibonacci(" + i + ") = " + fibonacci(i));
+    i = i + 1;
+  }
+}

package/examples/fizzbuzz.gg

@@ -0,0 +1,15 @@
+spawn {
+  equip i = 1;
+  grind (i <= 30) {
+    quest (i % 15 == 0) {
+      broadcast("FizzBuzz");
+    } side_quest (i % 3 == 0) {
+      broadcast("Fizz");
+    } side_quest (i % 5 == 0) {
+      broadcast("Buzz");
+    } retreat {
+      broadcast(i);
+    }
+    i = i + 1;
+  }
+}

package/examples/hello.gg

@@ -0,0 +1,4 @@
+spawn {
+  broadcast("Hello, World!");
+  broadcast("Welcome to GGLang! 🎮");
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "gglang",
-  "version": "1.0.0",
+  "version": "1.0.1",
   "description": "GGLang — A gaming-themed toy programming language built with TypeScript",
   "main": "dist/index.js",
   "bin": {