gen1recomp/src/core/Version.lua

-- Single source of every compatibility-relevant number: engine release,
-- mod API major, link protocol, save format and ROM cache generation.  Zero
-- requires so it loads during love.conf and under plain Lua for tools and
-- tests.

local Version = {
  engine = "0.0.0-dev",   -- game/engine release (semver).  Repo default is the
                          -- "-dev" placeholder; CI stamps the real X.Y.Z into
                          -- the packed game.love only, never the working tree.
  shell = 1,              -- native-shell contract this build implements
  payloadHost = "love",   -- native host family for in-place Lua payloads.
                          -- A payload must name the same family; this prevents
                          -- mounting code packaged for a different native host.
  minShell = 1,           -- lowest shell contract that can RUN this payload.
                          -- Bump only when a payload needs a newer native
                          -- binary (e.g. a LOVE version bump); an older shell
                          -- refuses to chainload a payload whose minShell
                          -- exceeds the shell it provides.
  modApi = 2,             -- mod API major (manifest `api`)
  linkProtocol = 2,       -- link handshake wire version (Handshake.PROTOCOL)
  saveFormat = 4,         -- save.meta.format
  cache = "rom-cache-v5", -- ROM import cache generation (RomImporter marker)
}

-- "gen1recomp v0.0.0-dev" (or the stamped release version in shipped builds)
function Version.title(base)
  return (base or "gen1recomp")
    .. " v" .. Version.engine
end

return Version