Nintendo Console (3DS, Switch) Support

.gitignore

@@ -4,3 +4,4 @@ zig-pkg
 .claude
 CLAUDE.md
 *.log
+*.wav

LICENSE.zitrus

@@ -0,0 +1,9 @@
+This project's 3DS backend uses components from Zitrus:
+
+Copyright © 2025 GasInfinity
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the “Software”), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED “AS IS”, WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

README.md

@@ -67,11 +67,6 @@ pub fn build(b: *std.Build) void {
         .overrides = overrides,
     });
 
-    // Compile a Slang shader for the selected backend and embed it at compile time
-    Aether.addShader(ae_dep.builder, b, exe, config, "basic", .{
-        .slang = b.path("shaders/basic.slang"),
-    });
-
     // Export the artifact (produces EBOOT.PBP for PSP, install artifact otherwise)
     Aether.exportArtifact(ae_dep.builder, b, exe, config, .{
         .title = "My Game",
@@ -83,7 +78,7 @@ pub fn build(b: *std.Build) void {
 }
 ```
 
-The first argument to `addGame`, `addShader`, and `exportArtifact` is the
+The first argument to `addGame` and `exportArtifact` is the
 dependency's builder (`ae_dep.builder`), and the second is your project's
 builder (`b`). This lets Aether resolve its own internal dependencies (GLFW,
 Vulkan, Slang, pspsdk) from its `build.zig.zon` while building artifacts that
@@ -117,11 +112,12 @@ const MyState = struct {
 };
 
 pub fn main(init: std.process.Init) !void {
-    const memory = try init.arena.allocator().alloc(u8, 32 * 1024 * 1024);
+    const memory = try init.gpa.alignedAlloc(u8, .fromByteUnits(16), 32 * 1024 * 1024);
+    defer init.gpa.free(memory);
 
     var my_state: MyState = undefined;
     var engine: ae.Engine = undefined;
-    try engine.init(init.io, memory, .{
+    try engine.init(init.io, init.environ_map, memory, .{
         .memory = .{
             .render = 8 * 1024 * 1024,
             .audio = 2 * 1024 * 1024,
@@ -159,10 +155,17 @@ zig build run -Dgfx=opengl
 # Build for PSP
 zig build -Dtarget=mipsel-psp
 
+# Build for 3DS
+zig build -Dtarget=arm-3ds-eabihf
+
 # Build in release mode
 zig build -Doptimize=ReleaseFast
 ```
 
+3DS builds default to a 4 MiB regular libctru/newlib heap and a 60 MiB
+linear heap. Aether's process allocator uses linear memory on 3DS, so engine
+pool allocations and GPU upload buffers come from the same memory class.
+
 ## Input System
 
 Actions are registered by name and bound to one or more input sources:
@@ -190,11 +193,9 @@ const Vertex = struct {
     });
     pub const Layout = Rendering.Pipeline.layout_from_struct(@This(), &Attributes);
 };
-
-const MyMesh = Rendering.Mesh(Vertex);
 ```
 
-Shaders are written in [Slang](https://shader-slang.com/) (`.slang` files), compiled at build time via `addShader`, and embedded into the binary. Vulkan consumes SPIR-V; OpenGL consumes GLSL 4.50. PSP targets ignore shaders entirely (fixed-function pipeline); the build system generates empty stubs.
+Aether owns its built-in pipeline shaders as backend internals. Downstream games create pipelines from vertex layouts; the selected backend compiles and embeds the shader code it needs.
 
 ## Build API Reference
 
@@ -210,15 +211,6 @@ Creates a game executable with the engine module and platform dependencies wired
 | `optimize` | `OptimizeMode` | Optimization level (default: `.Debug`) |
 | `overrides` | `Config.Overrides` | Graphics/display mode overrides (default: `.{}`) |
 
-### `Aether.addShader(owner, b, exe, config, name, paths)`
-
-Compiles a Slang shader for the selected backend and embeds it into the executable. Vulkan gets SPIR-V, OpenGL gets GLSL 4.50, and PSP targets get empty stubs.
-
-| Option | Type | Description |
-|--------|------|-------------|
-| `name` | `[]const u8` | Shader name (used for `@embedFile` lookup) |
-| `paths.slang` | `LazyPath` | Path to the `.slang` source file |
-
 ### `Aether.exportArtifact(owner, b, exe, config, opts)`
 
 Exports the build artifact. For PSP targets, produces an `EBOOT.PBP`. For desktop, installs the artifact normally.
@@ -233,7 +225,7 @@ Exports the build artifact. For PSP targets, produces an `EBOOT.PBP`. For deskto
 
 ### `Aether.Config.resolve(target, overrides) -> Config`
 
-Resolves the full engine configuration (platform, graphics backend, audio, input) from the build target and any user overrides. Pass the result to `addShader` and `exportArtifact`.
+Resolves the full engine configuration (platform, graphics backend, audio, input) from the build target and any user overrides. Pass the result to `exportArtifact`.
 
 ### `Aether.Config.Overrides`