feat: P.0.lib.camera 2D camera state + begin/finish wrapper

README.md

@@ -0,0 +1,33 @@
+# lib-core.camera
+
+P.0 2D camera state + begin/finish wrapper. Holds `target = {x, y}` + `zoom`,
+wraps `engine.render.camera_2d_begin/end` with current state.
+
+- Lib-ID: `lib-core.camera`
+- Version: `0.1.0`
+- Spec: `meta/docs/superpowers/specs/2026-05-09-p0-lib-camera-design.md`
+
+Forward-compat stubs (DEPRECATED-MVP) for follow, set_bounds, lerp_to, shake,
+set_rotation. See `meta/docs/architecture/render-pipeline.md` and
+`meta/docs/architecture/map-topology.md §7.3` for full target context.
+
+## API
+- `camera.set_target(x, y)` — set world-coords for screen-center
+- `camera.set_zoom(z)` — set zoom (positive number)
+- `camera.target() → {x, y}` — current target
+- `camera.zoom() → number` — current zoom
+- `camera.begin()` — push camera transform (must be inside render hook)
+- `camera.finish()` — pop camera transform (`end` is Lua keyword)
+
+## Consumer pattern
+```lua
+local camera = require("lib-core.camera")
+camera.set_target(256, 256)  -- world-coords
+camera.set_zoom(1.0)
+function render(ctx)
+    engine.render.clear_color(...)
+    camera.begin()
+    -- draw world here
+    camera.finish()
+end
+```