create-vimp-game 0.2.0 → 0.3.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-vimp-game",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "description": "Scaffolder for VIMP game plugins",
   "keywords": [
     "vimp",

package/src/cli.js

@@ -26,6 +26,8 @@ export const USAGE = `Usage: create-vimp-game <directory> [options]
   --title <title>    human-readable title
   --package <name>   npm package name (default: @vimp-games/<id>)
   --author <name>
+  --repository <url> project repository (URL or user/repo) — the engine links
+                     to it from the game's entry form
   --yes, -y          accept all defaults, no prompts
   --force            allow a non-empty target directory
   --no-git           skip \`git init\`
@@ -39,6 +41,7 @@ const VALUE_OPTIONS = new Map([
   ['--title', 'title'],
   ['--package', 'packageName'],
   ['--author', 'author'],
+  ['--repository', 'repository'],
   ['--engine-path', 'enginePath'],
   ['--core-path', 'corePath'],
 ]);
@@ -114,6 +117,9 @@ export function buildDefaults(args) {
     title: args.title ?? defaultTitle(id),
     packageName: args.packageName ?? defaultPackageName(id),
     author: args.author ?? '',
+    // репозиторий не выводится из author: тот — имя человека, а не логин на
+    // хостинге, и угаданный URL уехал бы битой ссылкой в футер к игрокам
+    repository: args.repository ?? '',
   };
 }
 
@@ -200,6 +206,7 @@ export async function main(argv) {
     force: args.force === true,
     enginePath: args.enginePath,
     corePath: args.corePath,
+    repository: answers.repository,
   });
 
   if (args.git) {

package/src/generator.js

@@ -144,6 +144,29 @@ async function applyEnginePath(targetDir, enginePath) {
   await writeFile(file, `${JSON.stringify(manifest, null, 2)}\n`, 'utf8');
 }
 
+// Адрес проекта в package.json: движок берёт из него ссылку в футере формы
+// входа (docs/en/client.md), а правило контракта A7 предупреждает, когда поля
+// нет. Пишется только по явно заданному значению — угаданный URL уехал бы
+// битой ссылкой к игрокам.
+//
+// Раскрывается лишь шорткат `user/repo`: у пакета нулевые рантайм-зависимости,
+// поэтому движковый resolveProjectUrl сюда не импортируется — все остальные
+// формы (`git+ssh://`, хвост `.git`) он разбирает уже при чтении.
+async function applyRepository(targetDir, repository) {
+  const value = repository.trim();
+  const url = /^[\w.-]+\/[\w.-]+$/.test(value)
+    ? `https://github.com/${value}`
+    : value;
+
+  const file = path.join(targetDir, 'package.json');
+  const manifest = JSON.parse(await readFile(file, 'utf8'));
+
+  manifest.repository = { type: 'git', url: `git+${url}.git` };
+  manifest.homepage = `${url}#readme`;
+
+  await writeFile(file, `${JSON.stringify(manifest, null, 2)}\n`, 'utf8');
+}
+
 async function applyCorePath(targetDir, corePath) {
   const file = path.join(targetDir, 'Cargo.toml');
   const patch =
@@ -171,6 +194,7 @@ export async function generate({
   force = false,
   enginePath,
   corePath,
+  repository = '',
 }) {
   await ensureTargetDir(targetDir, { force });
 
@@ -185,6 +209,13 @@ export async function generate({
     await applyEnginePath(targetDir, enginePath);
   }
 
+  if (
+    repository.trim() !== '' &&
+    (await exists(path.join(targetDir, 'package.json')))
+  ) {
+    await applyRepository(targetDir, repository);
+  }
+
   if (
     corePath !== undefined &&
     (await exists(path.join(targetDir, 'Cargo.toml')))

package/src/prompts.js

@@ -72,6 +72,9 @@ export async function askAnswers(defaults, { interactive = true, derive } = {})
         'expected an npm package name, e.g. @vimp-games/space-arena',
       ),
       author: await ask('Author', defaults.author),
+      // пустой ответ допустим: поля repository тогда не будет вовсе, о чём
+      // скажет правило контракта A7
+      repository: await ask('Repository (URL or user/repo)', defaults.repository),
     };
   } finally {
     closePrompts();

package/src/versions.generated.json

@@ -1,4 +1,4 @@
 {
-  "engine": "0.16.0",
+  "engine": "0.18.0",
   "core": "0.8.4"
 }

package/templates/default/scripts/build-game-manifest.js

@@ -12,7 +12,6 @@ import { rangeToPattern } from './lib/rangeToPattern.js';
 // asset steps: it hashes what they produced.
 // Run: node scripts/build-game-manifest.js (build:manifest)
 
-const packageJsonPath = fileURLToPath(new URL('../package.json', import.meta.url));
 const distPath = fileURLToPath(new URL('../dist/', import.meta.url));
 const assetsPath = path.join(distPath, 'assets');
 const mapsPath = path.join(distPath, 'maps');
@@ -55,13 +54,6 @@ const version = createHash('sha256')
   .digest('hex')
   .slice(0, 16);
 
-// The npm version of this package. `version` above is a bundle hash — useful
-// to the engine, meaningless to a player; this is what the engine shows in
-// the #auth footer.
-const { version: packageVersion } = JSON.parse(
-  fs.readFileSync(packageJsonPath, 'utf8'),
-);
-
 const mapNames = fs
   .readdirSync(mapsPath)
   .filter(name => name.endsWith('.json'))
@@ -163,7 +155,6 @@ const manifest = {
   id: '{{GAME_ID}}',
   engineApi: ENGINE_API_VERSION,
   version,
-  packageVersion,
   title: '{{GAME_TITLE}}',
   entries: {
     client: `/games/{{GAME_ID}}/${clientFile}`,