hascii 0.1.0 → 0.1.1

package/Makefile

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

package/README.md

@@ -1,23 +1,21 @@
-# Hascii
-
-YAML-based fantasy console for the terminal.
+YAML ベースのファンタジーコンソール。ターミナルで動作する。
 
 ## Install
 
 ```bash
-npm install -g hascii
+bun add -g hascii
 ```
 
 ## Usage
 
 ```bash
-# Start TUI console
+# TUI コンソールを起動
 hascii
 
-# Run a cartridge file
+# カートリッジファイルを実行
 hascii game.yaml
 
-# Open in editor
+# エディタで開く
 hascii -e game.yaml
 ```
 
@@ -30,7 +28,22 @@ hascii -e game.yaml
 | X / K | Action B (cancel) |
 | ESC | Exit / Back |
 
-## YAML Format
+## Specs
+
+| Item | Value |
+|------|-------|
+| Screen | 80x22 |
+| Colors | 16 (0-15) |
+| SFX | 16 slots |
+| Patterns | 8 slots |
+| Channels | 4ch |
+| Waveforms | TRI, SAW, SQR, PLS, ORG, NOI, PHA, SIN |
+| Octave | 2-5 |
+| Volume | 0-7 |
+
+## Language
+
+Hascii は YAML で記述する宣言的なゲーム言語。Elm アーキテクチャ (init/update/draw) に基づいている。
 
 ```yaml
 # yaml-language-server: $schema=hascii/hascii.schema.json
@@ -59,126 +72,137 @@ draw:
   - print: [score, 0, 0]
 ```
 
-### Expressions
+### meta
 
-| 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
+ゲームのメタデータを定義する。
+
+| Key | Description |
+|-----|-------------|
+| `title` | ゲームタイトル |
+| `frame` | フレームレート (1-60) |
+| `bg` | 背景色 (0-15) |
+
+### init
+
+ゲーム開始時の初期状態を定義する。ここで定義した変数は update と draw から参照できる。
 
 ```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
+init:
+  x: 40
+  y: 10
+  items: [1, 2, 3]
+  player: { hp: 100, mp: 50 }
+```
+
+### update
+
+毎フレーム実行されるロジックを定義する。状態を変更するには `set` を使う。
+
+```yaml
+update:
+  # 変数を設定
+  - set: { x: 10, y: 20 }
+
+  # 条件付き (短縮形)
+  - if: condition
+    set: { x: 0 }
+
+  # 条件付き (then/else)
+  - if: condition
+    then:
+      - set: { x: 1 }
+    else:
+      - set: { x: 0 }
+
+  # ループ
+  - each: items
     as: item
-    cond: { gt: [item, 0] }
+    index: i
+    do:
+      - set: { score: { add: [score, item] } }
+
+  # 配列操作
+  - push: { to: arr, item: value }
+  - filter:
+      list: arr
+      as: item
+      cond: { gt: [item, 0] }
 ```
 
-### Drawing
+### draw
+
+毎フレームの描画処理を定義する。
 
 ```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
+  - cls:                    # 画面クリア
+  - fill: 10                # 塗りつぶし色 (0-15)
+  - stroke: 7               # 線の色 (0-15)
+  - noFill:                 # 塗りつぶし無効
+  - noStroke:               # 線無効
+  - rect: [x, y, w, h]      # 矩形
+  - circ: [x, y, r]         # 円
+  - print: [text, x, y]     # テキスト
 ```
 
-### 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 |
+### Expressions
+
+式は `{ operator: [args] }` の形式で記述する。
+
+| Expression | Description |
+|------------|-------------|
+| `{ add: [a, b] }` | 加算 |
+| `{ sub: [a, b] }` | 減算 |
+| `{ mul: [a, b] }` | 乗算 |
+| `{ div: [a, b] }` | 除算 |
+| `{ mod: [a, b] }` | 剰余 |
+| `{ min: [a, b] }` | 最小値 |
+| `{ max: [a, b] }` | 最大値 |
+| `{ rnd: [min, max] }` | 乱数 (整数) |
+| `{ abs: n }` | 絶対値 |
+| `{ floor: n }` | 切り捨て |
+| `{ eq: [a, b] }` | 等価 (0 or 1) |
+| `{ lt: [a, b] }` | 小なり |
+| `{ gt: [a, b] }` | 大なり |
+| `{ and: [a, b, ...] }` | 論理 AND |
+| `{ or: [a, b, ...] }` | 論理 OR |
+| `{ not: a }` | 論理 NOT |
+| `{ at: [arr, i] }` | 配列アクセス |
+| `{ len: arr }` | 配列の長さ |
 
 ### 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 |
+| `btn.left` | 左キー押下中 |
+| `btn.right` | 右キー押下中 |
+| `btn.up` | 上キー押下中 |
+| `btn.down` | 下キー押下中 |
+| `btn.a` | Z キー押下中 |
+| `btn.b` | X キー押下中 |
+| `btnPressed.left` | 左キー押した瞬間 |
+| `btnPressed.right` | 右キー押した瞬間 |
+| `btnPressed.up` | 上キー押した瞬間 |
+| `btnPressed.down` | 下キー押した瞬間 |
+| `btnPressed.a` | Z キー押した瞬間 |
+| `btnPressed.b` | X キー押した瞬間 |
 
 ## Editor
 
-The TUI console includes a built-in editor with tabs:
+TUI コンソールにはエディタが内蔵されている。
 
 | 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 |
+| CODE | YAML ソース編集 |
+| SPRITE | (未実装) |
+| MAP | (未実装) |
+| SFX | 効果音エディタ |
+| TRACKER | 4ch 音楽トラッカー |
+| PLAY | ゲームプレビュー |
+| DATA | セーブデータ |
+| QUIT | エディタ終了 |
 
 ## License
 

package/carts/snake.yaml

@@ -188,7 +188,7 @@ update:
                       wave: noi
                       freq: 200
                       length: 0.3
-                      volume: 40
+                      volume: 3
           - if:
               and:
                 - eq:
@@ -220,7 +220,7 @@ update:
                   wave: tri
                   freq: 1200
                   length: 0.08
-                  volume: 15
+                  volume: 1
                   effect: pitchDown
           - if:
               not: ate
@@ -290,3 +290,6 @@ draw:
           - Press Z to restart
           - 30
           - 12
+sfx:
+  "0":
+    volume: 4

package/carts/wave.yaml

@@ -29,7 +29,7 @@ update:
           wave: sin
           freq: { add: [200, { mul: [100, { sin: t }] }] }
           length: 0.2
-          volume: 50
+          volume: 4
 
 draw:
   - fill: 0