hascii 0.1.0

package/Makefile

@@ -0,0 +1,19 @@
+.PHONY: build check test pack publish publish-dry
+
+build:
+	bun run build
+
+check:
+	bun run check
+
+test:
+	bun test
+
+pack:
+	npm pack --dry-run
+
+publish-dry:
+	npm publish --dry-run
+
+publish:
+	npm publish

package/README.md

@@ -0,0 +1,185 @@
+# Hascii
+
+YAML-based fantasy console for the terminal.
+
+## Install
+
+```bash
+npm install -g hascii
+```
+
+## Usage
+
+```bash
+# Start TUI console
+hascii
+
+# Run a cartridge file
+hascii game.yaml
+
+# Open in editor
+hascii -e game.yaml
+```
+
+## Controls
+
+| Key | Action |
+|-----|--------|
+| Arrow keys / WASD | Move |
+| Z / J | Action A (confirm) |
+| X / K | Action B (cancel) |
+| ESC | Exit / Back |
+
+## YAML Format
+
+```yaml
+# yaml-language-server: $schema=hascii/hascii.schema.json
+
+meta:
+  title: "GAME"
+  frame: 10
+  bg: 0
+
+init:
+  x: 40
+  y: 10
+  score: 0
+
+update:
+  - if: btn.left
+    set: { x: { sub: [x, 1] } }
+  - if: btn.right
+    set: { x: { add: [x, 1] } }
+
+draw:
+  - cls:
+  - fill: 10
+  - rect: [x, y, 2, 1]
+  - stroke: 7
+  - print: [score, 0, 0]
+```
+
+### Expressions
+
+| Expression | Description |
+|------------|-------------|
+| `{ add: [a, b] }` | Addition |
+| `{ sub: [a, b] }` | Subtraction |
+| `{ mul: [a, b] }` | Multiplication |
+| `{ div: [a, b] }` | Division |
+| `{ mod: [a, b] }` | Modulo |
+| `{ min: [a, b] }` | Minimum |
+| `{ max: [a, b] }` | Maximum |
+| `{ rnd: [min, max] }` | Random integer |
+| `{ abs: n }` | Absolute value |
+| `{ floor: n }` | Floor |
+| `{ eq: [a, b] }` | Equal (returns 0 or 1) |
+| `{ lt: [a, b] }` | Less than |
+| `{ gt: [a, b] }` | Greater than |
+| `{ and: [a, b, ...] }` | Logical AND (variadic) |
+| `{ or: [a, b, ...] }` | Logical OR (variadic) |
+| `{ not: a }` | Logical NOT |
+| `{ at: [arr, i] }` | Array access |
+| `{ len: arr }` | Array length |
+
+### Statements
+
+```yaml
+# Set variables
+- set: { x: 10, y: 20 }
+
+# Conditional (short form)
+- if: condition
+  set: { x: 0 }
+
+# Conditional (with then/else)
+- if: condition
+  then:
+    - set: { x: 1 }
+  else:
+    - set: { x: 0 }
+
+# Loop with index
+- each: items
+  as: item
+  index: i
+  do:
+    - print: [item, 0, i]
+
+# Array operations
+- push: { to: arr, item: value }
+- filter:
+    list: arr
+    as: item
+    cond: { gt: [item, 0] }
+```
+
+### Drawing
+
+```yaml
+draw:
+  - cls:                    # Clear screen
+  - fill: 10                # Set fill color (0-15)
+  - stroke: 7               # Set stroke color (0-15)
+  - noFill:                 # Disable fill
+  - noStroke:               # Disable stroke
+  - rect: [x, y, w, h]      # Draw rectangle
+  - print: [text, x, y]     # Print text
+```
+
+### Colors (0-15)
+
+| Index | Color |
+|-------|-------|
+| 0 | Black |
+| 1 | Dark Blue |
+| 2 | Dark Green |
+| 3 | Dark Cyan |
+| 4 | Dark Red |
+| 5 | Dark Magenta |
+| 6 | Brown |
+| 7 | Light Gray |
+| 8 | Dark Gray |
+| 9 | Blue |
+| 10 | Green |
+| 11 | Cyan |
+| 12 | Red |
+| 13 | Magenta |
+| 14 | Yellow |
+| 15 | White |
+
+### Input
+
+| Variable | Description |
+|----------|-------------|
+| `btn.left` | Left arrow held |
+| `btn.right` | Right arrow held |
+| `btn.up` | Up arrow held |
+| `btn.down` | Down arrow held |
+| `btn.a` | Z key held |
+| `btn.b` | X key held |
+| `btnPressed.left` | Left arrow just pressed |
+| `btnPressed.right` | Right arrow just pressed |
+| `btnPressed.up` | Up arrow just pressed |
+| `btnPressed.down` | Down arrow just pressed |
+| `btnPressed.a` | Z key just pressed |
+| `btnPressed.b` | X key just pressed |
+
+## Editor
+
+The TUI console includes a built-in editor with tabs:
+
+| Tab | Description |
+|-----|-------------|
+| CODE | Edit YAML source |
+| SPRITE | 16x8 ASCII sprites |
+| MAP | 16x16 tile map |
+| SFX | Sound effects |
+| TRACKER | 4-channel music tracker |
+| PLAY | Preview game |
+| DATA | Save data |
+| QUIT | Exit editor |
+
+## License
+
+MIT

package/carts/draw.yaml

@@ -0,0 +1,69 @@
+# yaml-language-server: $schema=../hascii.schema.json
+# Draw pixels with arrow keys
+
+meta:
+  title: "DRAW"
+  frame: 11
+  bg: 8
+  art:
+    - "\x1b[100m               \x1b[0m"
+    - "\x1b[100m \x1b[41m  \x1b[43m  \x1b[42m  \x1b[46m  \x1b[44m  \x1b[45m  \x1b[100m \x1b[0m"
+    - "\x1b[100m \x1b[45m  \x1b[41m  \x1b[43m  \x1b[42m  \x1b[46m  \x1b[44m  \x1b[100m \x1b[0m"
+    - "\x1b[100m \x1b[44m  \x1b[45m  \x1b[41m  \x1b[43m  \x1b[42m  \x1b[46m  \x1b[100m \x1b[0m"
+    - "\x1b[100m               \x1b[0m"
+  description: "Draw pixels. Z and X change color."
+
+init:
+  x: 40
+  y: 10
+  color: 10
+  # Drawing history: separate arrays for x, y, color
+  px: []
+  py: []
+  pc: []
+
+update:
+  - if: btn.left
+    set: { x: { max: [0, { sub: [x, 1] }] } }
+  - if: btn.right
+    set: { x: { min: [79, { add: [x, 1] }] } }
+  - if: btn.up
+    set: { y: { max: [0, { sub: [y, 1] }] } }
+  - if: btn.down
+    set: { y: { min: [21, { add: [y, 1] }] } }
+
+  # Change color with Z/X buttons
+  - if: btnPressed.a
+    set: { color: { mod: [{ add: [color, 1] }, 16] } }
+  - if: btnPressed.b
+    set: { color: { mod: [{ add: [color, 15] }, 16] } }
+
+  # Record pixel when moving (using variadic or)
+  - if: { or: [btn.left, btn.right, btn.up, btn.down] }
+    then:
+      - push: { to: px, item: x }
+      - push: { to: py, item: y }
+      - push: { to: pc, item: color }
+
+draw:
+  - fill: 0
+  - cls:
+  - noStroke:
+
+  # Draw all recorded pixels (using index option)
+  - each: px
+    as: pxi
+    index: i
+    do:
+      - fill: { at: [pc, i] }
+      - rect: [pxi, { at: [py, i] }, 1, 1]
+
+  # Draw cursor
+  - fill: color
+  - rect: [x, y, 1, 1]
+
+  # Color indicator
+  - stroke: 7
+  - print: ["Color:", 1, 0]
+  - fill: color
+  - rect: [8, 0, 2, 1]

package/carts/hello.yaml

@@ -0,0 +1,22 @@
+# yaml-language-server: $schema=../hascii.schema.json
+# The simplest example - just display text
+
+meta:
+  title: "HELLO"
+  frame: 11
+  bg: 4
+  art:
+    - "\x1b[44m    \x1b[93m*\x1b[44m     \x1b[93m*\x1b[44m    \x1b[0m"
+    - "\x1b[44m  \x1b[96m~\x1b[44m    \x1b[97m#\x1b[44m    \x1b[96m~\x1b[44m  \x1b[0m"
+    - "\x1b[44m       \x1b[95m+\x1b[44m       \x1b[0m"
+    - "\x1b[44m  \x1b[96m~\x1b[44m         \x1b[96m~\x1b[44m  \x1b[0m"
+    - "\x1b[44m    \x1b[93m*\x1b[44m     \x1b[93m*\x1b[44m    \x1b[0m"
+  description: "The simplest example."
+
+init: {}
+
+update: []
+
+draw:
+  - stroke: 11
+  - print: ["Hello, Hascii!", 32, 10]

package/carts/move.yaml

@@ -0,0 +1,68 @@
+# yaml-language-server: $schema=../hascii.schema.json
+meta:
+  title: MOVE
+  frame: 14
+  bg: 1
+  art:
+    - "\e[41m      \e[93m^\e[41m        \e[0m"
+    - "\e[41m    \e[93m<\e[41m \e[46m##\e[41m \e[93m>\e[41m    \e[0m"
+    - "\e[41m      \e[93mv\e[41m        \e[0m"
+    - "\e[41m               \e[0m"
+    - "\e[41m  \e[90m..........\e[41m   \e[0m"
+  description: Move the box with arrow keys.
+init:
+  x: 35
+  y: 8
+update:
+  - if: btn.left
+    set:
+      x:
+        max:
+          - 0
+          - sub:
+              - x
+              - 1
+  - if: btn.right
+    set:
+      x:
+        min:
+          - 71
+          - add:
+              - x
+              - 1
+  - if: btn.up
+    set:
+      y:
+        max:
+          - 0
+          - sub:
+              - y
+              - 1
+  - if: btn.down
+    set:
+      y:
+        min:
+          - 17
+          - add:
+              - y
+              - 1
+draw:
+  - fill: 0
+  - cls: null
+  - noFill: null
+  - stroke: 14
+  - strokeStyle: round
+  - rect:
+      - x
+      - y
+      - 9
+      - 5
+  - stroke: 7
+  - print:
+      - Move me!
+      - add:
+          - x
+          - 1
+      - add:
+          - y
+          - 2

package/carts/pong.yaml

@@ -0,0 +1,185 @@
+# yaml-language-server: $schema=../hascii.schema.json
+# Classic Pong game with AI opponent
+
+meta:
+  title: "PONG"
+  frame: 12
+  bg: 4
+  art:
+    - "\x1b[44m+-----------+  \x1b[0m"
+    - "\x1b[44m|\x1b[97m#\x1b[44m     \x1b[93mo\x1b[44m   \x1b[91m#\x1b[44m|  \x1b[0m"
+    - "\x1b[44m|\x1b[97m#\x1b[44m     :    \x1b[91m#\x1b[44m|  \x1b[0m"
+    - "\x1b[44m|\x1b[97m#\x1b[44m         \x1b[91m#\x1b[44m|  \x1b[0m"
+    - "\x1b[44m+-----------+  \x1b[0m"
+  description: "Beat the CPU. First to 5 wins."
+
+init:
+  # Player paddle (left)
+  py: 8
+  # CPU paddle (right)
+  cy: 8
+  # Ball
+  bx: 40
+  by: 10
+  dx: 1
+  dy: 1
+  # Scores
+  ps: 0
+  cs: 0
+  # Game state: 0=playing, 1=player won, 2=cpu won
+  st: 0
+  # Speed timer
+  t: 0
+
+update:
+  # Restart on Z when game over
+  - if: { and: [st, btnPressed.a] }
+    set:
+      st: 0
+      ps: 0
+      cs: 0
+      bx: 40
+      by: 10
+      dx: 1
+      dy: 1
+
+  - if: { not: st }
+    then:
+      - set: { t: { add: [t, 1] } }
+
+      # Player paddle control
+      - if: btn.up
+        set: { py: { max: [1, { sub: [py, 1] }] } }
+      - if: btn.down
+        set: { py: { min: [16, { add: [py, 1] }] } }
+
+      # CPU AI: only react when ball is coming toward CPU (dx > 0)
+      # and ball is past center line (bx > 40)
+      - if: { and: [{ gt: [dx, 0] }, { gt: [bx, 40] }] }
+        then:
+          # Move toward ball position
+          - if: { lt: [{ add: [cy, 2] }, by] }
+            set: { cy: { min: [16, { add: [cy, 1] }] } }
+          - if: { gt: [{ add: [cy, 2] }, by] }
+            set: { cy: { max: [1, { sub: [cy, 1] }] } }
+
+      # When ball going away, slowly return to center
+      - if: { lt: [dx, 0] }
+        then:
+          - if: { eq: [{ mod: [t, 4] }, 0] }
+            then:
+              - if: { lt: [{ add: [cy, 2] }, 10] }
+                set: { cy: { add: [cy, 1] } }
+              - if: { gt: [{ add: [cy, 2] }, 10] }
+                set: { cy: { sub: [cy, 1] } }
+
+      # Ball movement
+      - set:
+          bx: { add: [bx, dx] }
+          by: { add: [by, dy] }
+
+      # Wall bounce (top/bottom)
+      - if: { lte: [by, 1] }
+        set: { dy: 1 }
+      - if: { gte: [by, 20] }
+        set: { dy: -1 }
+
+      # Player paddle hit (left) - angle depends on hit position
+      - if: { and: [{ lte: [bx, 5] }, { gte: [by, py] }, { lte: [by, { add: [py, 4] }] }] }
+        then:
+          - set: { dx: 1 }
+          # Top of paddle -> up, bottom -> down
+          - if: { lte: [by, { add: [py, 1] }] }
+            set: { dy: -1 }
+          - if: { gte: [by, { add: [py, 3] }] }
+            set: { dy: 1 }
+
+      # CPU paddle hit (right)
+      - if: { and: [{ gte: [bx, 74] }, { gte: [by, cy] }, { lte: [by, { add: [cy, 4] }] }] }
+        then:
+          - set: { dx: -1 }
+          - if: { lte: [by, { add: [cy, 1] }] }
+            set: { dy: -1 }
+          - if: { gte: [by, { add: [cy, 3] }] }
+            set: { dy: 1 }
+
+      # CPU scores (ball past left)
+      - if: { lt: [bx, 0] }
+        set:
+          cs: { add: [cs, 1] }
+          bx: 40
+          by: 10
+          dx: -1
+
+      # Player scores (ball past right)
+      - if: { gt: [bx, 79] }
+        set:
+          ps: { add: [ps, 1] }
+          bx: 40
+          by: 10
+          dx: 1
+
+      # Check win condition
+      - if: { gte: [ps, 5] }
+        set: { st: 1 }
+      - if: { gte: [cs, 5] }
+        set: { st: 2 }
+
+draw:
+  - fill: 0
+  - cls:
+
+  # Border
+  - noFill:
+  - stroke: 8
+  - strokeStyle: light
+  - rect: [0, 0, 80, 22]
+
+  # Center line
+  - stroke: 8
+  - print: ["|", 39, 2]
+  - print: ["|", 39, 4]
+  - print: ["|", 39, 6]
+  - print: ["|", 39, 8]
+  - print: ["|", 39, 10]
+  - print: ["|", 39, 12]
+  - print: ["|", 39, 14]
+  - print: ["|", 39, 16]
+  - print: ["|", 39, 18]
+  - print: ["|", 39, 20]
+
+  # Score display
+  - stroke: 11
+  - print: [ps, 30, 1]
+  - stroke: 8
+  - print: ["-", 36, 1]
+  - stroke: 9
+  - print: [cs, 42, 1]
+
+  # Player paddle (left, yellow)
+  - fill: 14
+  - noStroke:
+  - rect: [2, py, 2, 5]
+
+  # CPU paddle (right, red)
+  - fill: 12
+  - rect: [76, cy, 2, 5]
+
+  # Ball
+  - fill: 15
+  - rect: [bx, by, 2, 1]
+
+  # Win/Lose message
+  - if: { eq: [st, 1] }
+    then:
+      - stroke: 10
+      - print: ["YOU WIN!", 35, 10]
+      - stroke: 7
+      - print: ["Press Z", 36, 12]
+
+  - if: { eq: [st, 2] }
+    then:
+      - stroke: 12
+      - print: ["YOU LOSE", 35, 10]
+      - stroke: 7
+      - print: ["Press Z", 36, 12]

package/carts/rain.yaml

@@ -0,0 +1,69 @@
+# yaml-language-server: $schema=../hascii.schema.json
+# Digital rain effect
+
+meta:
+  title: "RAIN"
+  frame: 2
+  bg: 0
+  art:
+    - "\x1b[40m \x1b[92m|\x1b[40m  \x1b[32m|\x1b[40m  \x1b[92m|\x1b[40m  \x1b[32m|\x1b[40m  \x1b[92m|\x1b[40m \x1b[0m"
+    - "\x1b[40m \x1b[32m|\x1b[40m  \x1b[92m|\x1b[40m  \x1b[32m|\x1b[40m  \x1b[92m|\x1b[40m  \x1b[32m|\x1b[40m \x1b[0m"
+    - "\x1b[40m \x1b[32m.\x1b[40m  \x1b[32m|\x1b[40m  \x1b[32m.\x1b[40m  \x1b[32m|\x1b[40m  \x1b[32m.\x1b[40m \x1b[0m"
+    - "\x1b[40m    \x1b[32m.\x1b[40m      \x1b[32m.\x1b[40m    \x1b[0m"
+    - "\x1b[40m               \x1b[0m"
+  description: "Digital rain effect."
+
+init:
+  t: 0
+  d1: 5
+  d2: 12
+  d3: 3
+  d4: 8
+  d5: 15
+  d6: 1
+  d7: 9
+  d8: 6
+
+update:
+  - set:
+      t: { add: [t, 1] }
+      d1: { mod: [{ add: [d1, 1] }, 22] }
+      d2: { mod: [{ add: [d2, 1] }, 22] }
+      d3: { mod: [{ add: [d3, 1] }, 22] }
+      d4: { mod: [{ add: [d4, 1] }, 22] }
+      d5: { mod: [{ add: [d5, 1] }, 22] }
+      d6: { mod: [{ add: [d6, 1] }, 22] }
+      d7: { mod: [{ add: [d7, 1] }, 22] }
+      d8: { mod: [{ add: [d8, 1] }, 22] }
+
+draw:
+  - fill: 0
+  - cls:
+  - noStroke:
+
+  # Rain drops (bright heads)
+  - fill: 10
+  - rect: [10, d1, 1, 1]
+  - rect: [25, d2, 1, 1]
+  - rect: [40, d3, 1, 1]
+  - rect: [55, d4, 1, 1]
+  - rect: [70, d5, 1, 1]
+  - rect: [18, d6, 1, 1]
+  - rect: [33, d7, 1, 1]
+  - rect: [62, d8, 1, 1]
+
+  # Trails (dimmer)
+  - fill: 2
+  - rect: [10, { sub: [d1, 1] }, 1, 1]
+  - rect: [25, { sub: [d2, 1] }, 1, 1]
+  - rect: [40, { sub: [d3, 1] }, 1, 1]
+  - rect: [55, { sub: [d4, 1] }, 1, 1]
+  - rect: [70, { sub: [d5, 1] }, 1, 1]
+  - rect: [18, { sub: [d6, 1] }, 1, 1]
+  - rect: [33, { sub: [d7, 1] }, 1, 1]
+  - rect: [62, { sub: [d8, 1] }, 1, 1]
+
+  - rect: [10, { sub: [d1, 2] }, 1, 1]
+  - rect: [25, { sub: [d2, 2] }, 1, 1]
+  - rect: [40, { sub: [d3, 2] }, 1, 1]
+  - rect: [55, { sub: [d4, 2] }, 1, 1]