lib-core.maps

P.0 single-tile-grid-map implementation. Loads JSON map + tilemap files, provides tile-fetch + walkability queries.

• Lib-ID: lib-core.maps
• Version: 0.1.0
• Spec: meta/docs/superpowers/specs/2026-05-09-p0-lib-maps-design.md

Forward-compat stubs (DEPRECATED-MVP) for multi-map graph, lifecycle states, walls, sprite-fields, generators, save-integration. See meta/docs/architecture/map-topology.md for the full target spec.

API

• maps.load(path) — load + register a map from JSON
• maps.create(table) — programmatic creation (tests, procedural)
• maps.tile_at(map_id, tx, ty) / maps.tile_at(tx, ty) — current-map sugar
• maps.is_walkable(...), maps.size(...), maps.tile_size(...)
• maps.current(), maps.set_current(id), maps.list()
• Stubs (deferred): maps.state(), maps.pin()