tapmach 0.2.1 → 0.3.1

package/README.md

@@ -1,51 +1,89 @@
+![Banner](assets/logo.png)
+
 # tapmach
 
-**tapmach** tape-based programming language designed for visual execution and extreme simplicity. It focuses on manipulating a dynamic array of cells through a clean, terminal-inspired interface.
+**tapmach**, a list-based programming language designed for visual execution and extreme simplicity. It focuses on manipulating a dynamic array of cells through a clean interface. It is also quite performant.
 
 >[!note]
-> All the claims of performance are restrained by the execution speed of javascript. So don't really think this can beat C or other high performance programming languages.
+> All the claims of performance are restrained by the execution speed of javascript. So don't assume this can beat C or other high performance programming languages.
 
----
 
-### 🚀 Getting Started
+## 🚀 Getting Started
 
 To run the Tapmach environment, ensure you have **Bun** installed, then execute:
 
 ```bash
-bun run index.ts
+bun add -g tapmach
 ```
 
-The server will start at `http://localhost:3000`. Use the built-in editor to write your code and hit the **Run** button to see the tape come to life. To stop the server, press `q` in your terminal.
+This will install tapmach on your system. To run the server just type `tapmach` on the command line.
+
+The server will start at `http://localhost:3000`. Use the built-in editor to write your code and hit the **Run** button to see the your program come to life. To stop the server, press `q` in your terminal.
+
+>[!note]
+> I am quite sorry but `Ctrl+C` doesn't work if you want to exit the program.
 
----
 
-### 📜 Language Reference
+## 📜 Language Reference
 
 Tapmach operates on a **Tape** (a sequence of cells). You interact with the "current" cell by creating, modifying, or destroying it.
 
+The tape can be understood as the memory of the program in the form of a list. Also it is the only type of data-structure you can use in this programming language.
+
+There are currently 3 instruction sets to suit different tastes.
+You can switch to a different instruction set using the `Modes` dropdown menu.
+
+Now lets understand the syntax of all the 3 instruction sets.
+
+### `Default` Instruction Set
+
+It has the following instruction set -
+
+
+| Instruction | Description |
+| :--- | :--- |
+| `create_cell` | Appends a new cell to the end of the tape/memory with an initial value of `0`. |
+| `add <number>` | Adds the specified integer to the value of the currently active cell. |
+| `destroy_cell`| Removes the current cell from the tape/memory. |
+| `move <number>` | Moves through the tape/memory with the specified integer. |
+
+
+Now one important thing to note here is that the `add` and `move` instructions can receive negative integers.
+
+
+### `Shortcodes` Instruction Set
+
+The instruction set of this is similar to the `Default` Instruction Set and is just composed of shortcodes.
+
+
 | Instruction | Description |
 | :--- | :--- |
-| `create_cell` | Appends a new cell to the end of the tape with an initial value of `0`. |
+| `cc` | Appends a new cell to the end of the tape/memory with an initial value of `0`. |
 | `add <number>` | Adds the specified integer to the value of the currently active cell. |
-| `destroy_cell`| Removes the current cell from the tape with a visual collapse animation. |
+| `dc`| Removes the current cell from the tape/memory. |
+| `mov <number>` | Moves through the tape/memory with the specified integer. |
+
+
+### `Numberless Shortcodes` Instruction Set
 
 >[!note]
-> Every line in Tapmach is treated as a distinct operation followed by a 1-second delay to allow the visual animations to complete.
+> Actual meaning of numberless is countless, but sometimes it can refer to absence of numbers.
 
----
+This instruction set has a little more keywords. Since there are no numbers.
 
-### 🛠 Technical Architecture
 
-The project is built with a high-performance, "HTML-First" mindset:
+| Instruction | Description |
+| :--- | :--- |
+| `cc` | Appends a new cell to the end of the tape/memory with an initial value of `0`. |
+| `add` | Adds 1 to the value of the currently active cell. |
+| `sub` | Subtracts 1 to the value of the currently active cell. |
+| `dc` | Removes the current cell from the tape/memory. |
+| `mov` | Moves forward in the tape/memory with a value of 1. |
+| `vom` | Moves backward in the tape/memory with a value of a value of 1. |
 
-* **Runtime:** Powered by **Bun** for fast I/O and dev-server capabilities.
-* **Frontend:** Pure HTML/CSS/JS.
-* **Styling:** Features a minimalist UI.
-* **State:** Code is automatically persisted to `localStorage` using a debounced saving mechanism, ensuring you never lose your work.
 
----
+## 🎨 Design Goals
 
-### 🎨 Design Goals
+* **Minimalist UI:** No clutter, just the code and output.
+* **Performance:** Lightweight execution with minimal dependencies.
 
-* **Minimalist UI:** No clutter, just the tape and the code.
-* **Performance:** Lightweight execution with minimal dependencies (`ansis` for terminal styling and `Bun.serve` for the backend).

package/dist/index.js

@@ -391,11 +391,15 @@ var main_default = `<!DOCTYPE html>
 </head>
 <body>
     <div class="controls-header">
+        <div class="status">
+            -
+        </div>
         <div class="lang-control">
             <label for="lang">Mode:</label>
             <select id="lang">
                 <option value="default">Default</option>
                 <option value="shortcodes">Shortcodes</option>
+                <option value="numberless shortcodes">Numberless Shortcodes</option>
             </select>
         </div>
         <div class="speed-control">
@@ -485,6 +489,26 @@ var main_default = `<!DOCTYPE html>
             }
         }
 
+        function tokenToCode_Numberless_Shortcodes(code, currentToken, nextToken, speed) {
+            if (currentToken === 'cc') {
+                code.push('create_cell();');
+            } else if (currentToken === 'dc') {
+                code.push('destroy_cell();');
+            } else if (currentToken === 'add') {
+                code.push('add(1);')
+            } else if (currentToken === 'sub') {
+                code.push('add(-1);')
+            } else if (currentToken === 'mov') {
+                code.push('move(1);')
+            } else if (currentToken === 'vom') {
+                code.push('move(-1);')
+            } else if (currentToken === 'line_end') {
+                code.push(\`await sleep(\${speed});\`);
+            } else {
+                throw Error(\`Can't parse the code, wrong instruction: \${currentToken}\`);
+            }
+        }
+        
         function convertToCode(text, lang = 'default') {
             let tokens = parse(text);
             const speed = document.getElementById('speed').value || 1000;
@@ -494,17 +518,22 @@ var main_default = `<!DOCTYPE html>
                 tokenToCode = tokenToCode_Default;
             } else if (lang === 'shortcodes') {
                 tokenToCode = tokenToCode_Shortcodes;
+            } else if (lang === 'numberless shortcodes') {
+                tokenToCode = tokenToCode_Numberless_Shortcodes;
             } else {
                 tokenToCode = tokenToCode_Default;
             }
 
+            code.push(\`status.style.color = '#eed49f';status.innerHTML = ' ... ';\`);
+
             for (let i = 0; i < tokens.length; i++) {
                 tokenToCode(code, tokens[i], tokens[i+1], speed);
             }
-            
+           
+            code.push(\`status.innerHTML = ' :) ';status.style.color = '#a6da95';setTimeout(() => { status.style.color = '#cad3f5'; status.innerHTML = ' - '; }, 2000);\`);
             code.push('})();')
             code = code.join('');
-
+            
             return code;
         }
     </script>
@@ -556,7 +585,7 @@ var main_default = `<!DOCTYPE html>
         let current_cell = 0;
         let list = [];
 
-        async function update() {
+        function update() {
             if (cells.length === 0) return;
 
             const target = cells[current_cell];
@@ -569,7 +598,7 @@ var main_default = `<!DOCTYPE html>
             target.classList.add('animate-update')
         }
 
-        async function create_cell() {
+        function create_cell() {
             const val = 0;
             const div = document.createElement('div');
             div.classList.add('cell', 'animate-create', \`i\${list.length+1}\`);
@@ -592,17 +621,30 @@ var main_default = `<!DOCTYPE html>
             update();
         }
 
-        async function destroy_cell() {
+        function destroy_cell() {
             const target = cells[current_cell];
             if (typeof target === null) return;
 
             target.classList.add('animate-destroy');
 
-            setTimeout(() => target.remove(), 300);
-            move(-1);
+            setTimeout(() => {
+                target.remove();
+            }, 300);
+            if (current_cell === 0) {
+                move(1);
+                list.splice(current_cell-1, 1);
+                cells.splice(current_cell-1, 1);
+                current_cell = 0;
+            } else {
+                move(-1);
+                list.splice(current_cell+1, 1);
+                cells.splice(current_cell+1, 1);
+            }
+
+            console.log(current_cell);
         }
 
-        async function move(index) {
+        function move(index) {
             if (current_cell+index < 0 || current_cell+index >= cells.length) return;
 
             previous_cell = current_cell;
@@ -631,9 +673,11 @@ var main_default = `<!DOCTYPE html>
 
     <script>
         const button = document.querySelector('.run-btn');
+        const status = document.querySelector('.status');
         button.addEventListener('click', async (e) => {
             let text = localStorage.getItem('text-content');
             let selectedLang = localStorage.getItem('selectedLang');
+
             eval(convertToCode(text, selectedLang));
         })
     </script>

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "tapmach",
-  "version": "0.2.1",
+  "version": "0.3.1",
   "module": "./src/index.ts",
   "type": "module",
   "private": false,