Packed chunk

.envrc

@@ -0,0 +1 @@
+PATH_add bin

.gitignore

@@ -11,14 +11,13 @@ vendor/pcre
 *.dylib
 *.dll
 *.a
-bin/
 scratch/
 tools/build_helpers
 tools/build_helpers.exe
 logs/
 *.exe
 *.out
-
+*.log
 
 app/.import
 .DS_Store
@@ -38,7 +37,6 @@ user_config.nims
 nimble.develop
 nimble.paths
 /t.nim
-fonts/
 .submodules.tmp
 
 *.previous

.vscode/tasks.json

@@ -5,7 +5,7 @@
   "tasks": [
     {
       "label": "Build enu",
-      "command": "nimble",
+      "command": "nim",
       "args": [
         "build",
         "--debugger:native"

AGENTS.md

@@ -0,0 +1 @@
+CLAUDE.md

CLAUDE.md

@@ -12,6 +12,18 @@ Enu is a 3D sandbox environment for creating and exploring voxel worlds using a
 - `atlas install && atlas rep` - Install dependencies (first-time setup)
 - `nim prereqs` - Build Godot, download fonts, generate API bindings and stdlib
 
+### Dependency Management (Atlas)
+
+- `atlas.lock` pins exact dependency versions
+- `atlas pin <package>` - Update lock file for a specific package after changing its version in deps/
+- `atlas install` - Install dependencies from lock file
+- `atlas rep` - Regenerate nim.cfg paths from lock file
+- When changing dependencies in enu.nimble, run `atlas install && atlas pin` to update the lock file
+
+### Generated Artifacts
+
+**Never manually edit files that are meant to be produced by tools** (lock files, sentinel files, zip archives, etc.), even if you know how to make the required changes. We need to verify our tools work correctly and eliminate potential failure vectors. If a tool isn't producing the expected output, investigate why. Confirm with the user before making any exceptions.
+
 ### Core Development Commands
 - `nim build` - Build the main application (required after code changes)
 - `nim start` - Run Enu in development mode
@@ -84,16 +96,26 @@ Pass `amd64` or `arm64` to `nim prereqs` to set the target architecture. See `do
 - Controllers manage game logic and coordinate between models and UI
 - UI components handle presentation and user interaction
 
-### Important Notes
+### Casing Conventions
 
-- **Always use `snake_case` for identifiers.** Nim's identifier normalization means `snake_case` and `camelCase` are equivalent, but this project strictly uses `snake_case`. Only use `lowerCamelCase` when `snake_case` doesn't work, which should only happen with third-party macros that don't properly normalize identifiers.
+This project follows Ruby-like casing conventions. Nim is style-insensitive for identifiers (ignoring case and underscores), so these are style guidelines rather than compiler requirements:
+
+- **Types**: `UpperCamelCase` (e.g., `VoxelRenderer`, `GameState`, `Build`)
+- **Enum values**: `SCREAMING_SNAKE_CASE` (e.g., `ERASER`, `BLUE`, `CODE_MODE`, `PLAYING`)
+- **Constants**: `SCREAMING_SNAKE_CASE` (e.g., `CHUNK_DIM`, `ACTION_COLORS`, `IR_BLACK`)
+- **Everything else**: `snake_case` (procs, variables, fields, parameters, etc.)
+- **Third-party identifiers starting with lowercase**: use `snake_case` (e.g., `writeVu64` → `write_vu64`)
+
+Only use `lowerCamelCase` when `snake_case` doesn't work, which should only happen with third-party macros that don't properly normalize identifiers.
+
+### Important Notes
 - Use `nim build` to verify changes compile correctly
 - The project uses ZenContext for metrics and threading
 - Scripts are Logo-inspired but use Nim syntax
 - World data is stored as JSON with accompanying Nim scripts
 - If you're not on `main` or a `0.x` branch, try to keep a clean history. Prefer rebasing and ammending commits to keep work in
   logical chunks and --force-with-lease push them to origin. Confirm with the user before pulling.
-- Never include "Generated by Claude", "Co-Authored-By: Claude", or similar attribution in commits. Keep commit messages concise. Try not to include details that are obvious by quickly looking at the diff.
+- **Never include "Generated by Claude", "Co-Authored-By: Claude"**, or similar attribution in commits. Keep commit messages concise. Try not to include details that are obvious by quickly looking at the diff.
 - If rebasing or squashing commits, confirm with the user before merging 10 or more commits.
 - Avoid nil checks, unless there is a known, non-bug reason why something could be nil. Asserting something isn't nil is fine.
 - Things that are fairly obvious shouldn't have comments.

atlas.lock

@@ -12,10 +12,10 @@
       "commit": "3aeb5a61f306a0ad4f5a7292cfdc69af2fa35e4d",
       "version": ""
     },
-    "model_citizen.getenu.github.com": {
-      "dir": "$deps/model_citizen.getenu.github.com",
-      "url": "https://github.com/getenu/model_citizen",
-      "commit": "cbc2c9d6a645b993ec76650b7735a9e927b223e0",
+    "ed.getenu.github.com": {
+      "dir": "$deps/ed.getenu.github.com",
+      "url": "https://github.com/getenu/ed",
+      "commit": "c12f6d673c46d4d765e1cfb3ccfdf86a8306d946",
       "version": ""
     },
     "nanoid.nim.getenu.github.com": {
@@ -75,7 +75,7 @@
     "zippy": {
       "dir": "$deps/zippy",
       "url": "https://github.com/guzba/zippy",
-      "commit": "a0057dcc689bae60adfc286b8e49dc10db4c98d3",
+      "commit": "9ab82da84edfd6483d273dfcf8a921309945861e",
       "version": ""
     },
     "unittest2": {
@@ -84,6 +84,24 @@
       "commit": "1efa65bb037185f0983ac4fa65932e8d3450825d",
       "version": ""
     },
+    "nph": {
+      "dir": "$deps/nph",
+      "url": "https://github.com/arnetheduck/nph",
+      "commit": "1c6d7813f9f6d6a4fbcd36dfd1489b18982d0d55",
+      "version": ""
+    },
+    "regex": {
+      "dir": "$deps/regex",
+      "url": "https://github.com/nitely/nim-regex",
+      "commit": "4593305ed1e49731fc75af1dc572dd2559aad19c",
+      "version": ""
+    },
+    "nim-libbacktrace.dsrw.github.com": {
+      "dir": "$deps/nim-libbacktrace.dsrw.github.com",
+      "url": "https://github.com/dsrw/nim-libbacktrace",
+      "commit": "d8bd4ce5c46bb6d2f984f6b3f3d7380897d95ecb",
+      "version": ""
+    },
     "threading": {
       "dir": "$deps/threading",
       "url": "https://github.com/nim-lang/threading",
@@ -105,7 +123,7 @@
     "supersnappy": {
       "dir": "$deps/supersnappy",
       "url": "https://github.com/guzba/supersnappy",
-      "commit": "e4df8cb5468dd96fc5a4764028e20c8a3942f16a",
+      "commit": "4fed6553d539cbbfb17ab5fea16a58b4f1916e7d",
       "version": ""
     },
     "faststreams": {
@@ -150,6 +168,30 @@
       "commit": "0646c444fce7c7ed08ef6f2c9a7abfd172ffe655",
       "version": ""
     },
+    "hldiff": {
+      "dir": "$deps/hldiff",
+      "url": "https://github.com/c-blake/hldiff",
+      "commit": "cc1fc22a18c57e16d89c580cf78478c38c394c66",
+      "version": ""
+    },
+    "glob": {
+      "dir": "$deps/glob",
+      "url": "https://github.com/haltcase/glob",
+      "commit": "dfb567fe1803d08b2e6272c56f30885c8a63f4d1",
+      "version": ""
+    },
+    "toml_serialization": {
+      "dir": "$deps/toml_serialization",
+      "url": "https://github.com/status-im/nim-toml-serialization",
+      "commit": "b5b387e6fb2a7cc75d54a269b07cc6218361bd46",
+      "version": ""
+    },
+    "unicodedb": {
+      "dir": "$deps/unicodedb",
+      "url": "https://github.com/nitely/nim-unicodedb",
+      "commit": "66f2458710dc641dd4640368f9483c8a0ec70561",
+      "version": ""
+    },
     "stew": {
       "dir": "$deps/stew",
       "url": "https://github.com/status-im/nim-stew",
@@ -191,14 +233,20 @@
       "url": "https://github.com/status-im/nim-http-utils",
       "commit": "c53852d9e24205b6363bba517fa8ee7bde823691",
       "version": ""
+    },
+    "adix": {
+      "dir": "$deps/adix",
+      "url": "https://github.com/c-blake/adix",
+      "commit": "38a95ee6bd675b31746fa79d318b546495374ffa",
+      "version": ""
     }
   },
   "nimcfg": [
     "############# begin Atlas config section ##########",
     "--noNimblePath",
     "--path:\"deps/Nim.getenu.github.com\"",
     "--path:\"deps/godot-nim.getenu.github.com/godot\"",
-    "--path:\"deps/model_citizen.getenu.github.com/src\"",
+    "--path:\"deps/ed.getenu.github.com/src\"",
     "--path:\"deps/nanoid.nim.getenu.github.com/src\"",
     "--path:\"deps/pretty/src\"",
     "--path:\"deps/cligen\"",
@@ -210,6 +258,9 @@
     "--path:\"deps/metrics\"",
     "--path:\"deps/zippy/src\"",
     "--path:\"deps/unittest2\"",
+    "--path:\"deps/nph/src\"",
+    "--path:\"deps/regex/src\"",
+    "--path:\"deps/nim-libbacktrace.dsrw.github.com\"",
     "--path:\"deps/threading\"",
     "--path:\"deps/flatty/src\"",
     "--path:\"deps/netty/src\"",
@@ -223,11 +274,16 @@
     "--path:\"deps/chronos\"",
     "--path:\"deps/results\"",
     "--path:\"deps/stew\"",
+    "--path:\"deps/hldiff\"",
+    "--path:\"deps/glob/src\"",
+    "--path:\"deps/toml_serialization\"",
+    "--path:\"deps/unicodedb/src\"",
     "--path:\"deps/fusion/src\"",
     "--path:\"deps/mustache/src\"",
     "--path:\"deps/parsetoml/src\"",
     "--path:\"deps/bearssl\"",
     "--path:\"deps/httputils\"",
+    "--path:\"deps/adix\"",
     "############# end Atlas config section   ##########",
     ""
   ],
@@ -244,16 +300,17 @@
       "",
       "requires \"https://github.com/getenu/Nim#77d820e1\",",
       "  \"https://github.com/getenu/godot-nim 0.8.6\",",
-      "  \"https://github.com/getenu/model_citizen 0.19.10\",",
+      "  \"https://github.com/getenu/ed 0.20.0\",",
       "  \"https://github.com/getenu/nanoid.nim >= 0.2.1\",",
       "  \"https://github.com/treeform/pretty >= 0.2.0\", \"cligen\", \"chroma\", \"markdown\",",
-      "  \"chronicles\", \"dotenv\", \"nimibook\", \"metrics#51f1227\", \"zippy\", \"unittest2\"",
+      "  \"chronicles\", \"dotenv\", \"nimibook\", \"metrics#51f1227\", \"zippy\", \"unittest2\",",
+      "  \"nph\", \"regex\", \"https://github.com/dsrw/nim-libbacktrace\"",
       ""
     ]
   },
   "hostOS": "macosx",
   "hostCPU": "arm64",
-  "nimVersion": "2.2.6 ab00c56904e3126ad826bb520d243513a139436a",
+  "nimVersion": "2.2.6",
   "gccVersion": "",
   "clangVersion": ""
 }

bin/config.nims

@@ -0,0 +1 @@
+patch_file "nph", "phrenderer", "patches/phrenderer"

bin/docs.nim

@@ -0,0 +1,76 @@
+import std/[asynchttpserver, asyncdispatch, os, strutils, mimetypes]
+
+const
+  project_path = current_source_path().parent_dir().parent_dir()
+  vendor_path = project_path / "vendor"
+  voxel_docs_path = vendor_path / "modules/voxel/doc/site"
+  godot_docs_path = vendor_path / "godot/doc/_build/html"
+  enu_docs_path = project_path.parent_dir() / "enu-site"
+  port = 9999
+
+proc handle_request(req: Request) {.async, gcsafe.} =
+  var path = req.url.path
+
+  # Determine which docs to serve based on path prefix
+  var docs_path: string
+  var relative_path: string
+
+  if path.starts_with("/voxel"):
+    docs_path = voxel_docs_path
+    relative_path = path[6 ..^ 1] # Strip "/voxel"
+  elif path.starts_with("/godot"):
+    docs_path = godot_docs_path
+    relative_path = path[6 ..^ 1] # Strip "/godot"
+  elif path.starts_with("/enu"):
+    docs_path = enu_docs_path
+    relative_path = path[4 ..^ 1] # Strip "/enu"
+  elif path == "/" or path == "":
+    # Serve index page with links to all
+    let index_html =
+      """<!DOCTYPE html>
+<html><head><title>Docs</title></head>
+<body>
+<h1>Local Documentation</h1>
+<ul>
+  <li><a href="/enu/">Enu docs</a></li>
+  <li><a href="/voxel/">godot-voxel module docs</a></li>
+  <li><a href="/godot/">Godot 3.5 class reference</a></li>
+</ul>
+</body></html>"""
+    await req.respond(
+      HTTP200, index_html, new_http_headers([("Content-Type", "text/html")])
+    )
+    return
+  else:
+    await req.respond(HTTP404, "Not found. Try <a href=\"/\">/</a> for index.")
+    return
+
+  # Handle empty path or directory paths
+  if relative_path == "" or relative_path == "/":
+    relative_path = "/index.html"
+  elif not relative_path.contains('.'):
+    relative_path = relative_path / "index.html"
+
+  let file_path = docs_path / relative_path
+
+  if file_exists(file_path):
+    let content = read_file(file_path)
+    let ext = file_path.split_file().ext
+    let mimes = new_mimetypes()
+    let mime =
+      mimes.get_mimetype(ext.strip(chars = {'.'}), default = "text/html")
+    await req.respond(
+      Http200, content, new_http_headers([("Content-Type", mime)])
+    )
+  else:
+    await req.respond(Http404, "Not found: " & path)
+
+proc main() =
+  echo "Serving docs at http://localhost:", port
+  echo "  /enu/   -> Enu docs"
+  echo "  /voxel/ -> godot-voxel docs"
+  echo "  /godot/ -> Godot 3.5 class reference"
+  let server = new_async_http_server()
+  wait_for server.serve(port.Port, handle_request)
+
+main()

bin/nph.nim

@@ -0,0 +1 @@
+include pkg/nph

bin/patches/phrenderer.nim

@@ -0,0 +1,22 @@
+# stupider like a fox!
+
+import std/[strutils, macros]
+import pkg/regex
+
+macro patch_line_length() =
+  # strip "." from imports, since they're not siblings to this patch file but
+  # are on the nim path
+  const import_regex = re2(r"import ""\.""\/\[(.*)\]")
+
+  let
+    path = "../../deps/nph/src/phrenderer.nim"
+    src = static_read path
+    og_line_length = "44 else: 88"
+    new_line_length = "40 else: 80"
+    patched = src.replace(import_regex, "import $1").replace(
+        og_line_length, new_line_length
+      )
+
+  parse_stmt(patched, path)
+
+patch_line_length()