@sbugallo/pokecode 0.0.0-stage → 0.2.0

package/dist/application/use-cases/resolve-progression.js

@@ -0,0 +1,80 @@
+import { evolutionAtLevel, movesAtLevel, progressionFor } from "../../domain/progression/catalog.js";
+import { nextLevelAdvance } from "../../domain/progression/policies.js";
+import { learnMove } from "./learn-move.js";
+export function resolveUsageLevels(stores, trainerId, regionId, createdAt, createId) {
+    for (const pokemon of stores.pokemon.party(trainerId)) {
+        resolvePokemonLevels(stores, trainerId, pokemon, regionId, createdAt, createId);
+    }
+}
+/** Resume saved progression for one owned Pokémon, including one in the PC. */
+export function resolveOwnedPokemonLevels(stores, trainerId, pokemonId, regionId, createdAt, createId) {
+    const pokemon = stores.pokemon.findOwned(trainerId, pokemonId);
+    if (pokemon === null)
+        return;
+    resolvePokemonLevels(stores, trainerId, pokemon, regionId, createdAt, createId);
+}
+/** Preserve party resumption and additionally drain deferred XP on PC Pokémon. */
+export function resolveUnblockedPokemonLevels(stores, trainerId, regionId, createdAt, createId) {
+    resolveUsageLevels(stores, trainerId, regionId, createdAt, createId);
+    for (const pokemon of stores.pokemon.offPartyWithExperience(trainerId)) {
+        resolvePokemonLevels(stores, trainerId, pokemon, regionId, createdAt, createId);
+    }
+}
+/** Process saved XP only, excluding untouched party/PC Pokémon from queue-drain side effects. */
+export function resolveSavedExperienceLevels(stores, trainerId, regionId, createdAt, createId) {
+    const partyWithExperience = stores.pokemon
+        .party(trainerId)
+        .filter((pokemon) => pokemon.experience > 0);
+    for (const pokemon of [
+        ...partyWithExperience,
+        ...stores.pokemon.offPartyWithExperience(trainerId),
+    ]) {
+        resolvePokemonLevels(stores, trainerId, pokemon, regionId, createdAt, createId);
+    }
+}
+function resolvePokemonLevels(stores, trainerId, pokemon, regionId, createdAt, createId) {
+    let speciesId = pokemon.speciesId;
+    let level = pokemon.level;
+    let experience = pokemon.experience;
+    while (true) {
+        // Check the current level too: captures and newly evolved species may have
+        // already passed their milestone, including the Azurill -> Marill chain.
+        const evolution = evolutionAtLevel(speciesId, level, pokemon.gender, regionId);
+        if (evolution !== null) {
+            if (evolution.targets.length > 1) {
+                if (!stores.choices.hasPokemonChoice(trainerId, pokemon.id, "evolution")) {
+                    stores.choices.insert({
+                        id: createId(),
+                        trainerId,
+                        kind: "evolution",
+                        payload: { pokemonId: pokemon.id, options: [...evolution.targets] },
+                        createdAt,
+                    });
+                }
+                // Keep the remaining XP on the Pokémon until its species is selected.
+                return;
+            }
+            const target = evolution.targets[0];
+            speciesId = target.speciesId;
+            stores.pokemon.evolve(pokemon.id, target.speciesId, target.name);
+            for (const move of movesAtLevel(speciesId, level)) {
+                learnMove(stores, { trainerId, pokemonId: pokemon.id, move, createdAt, createId });
+            }
+            continue;
+        }
+        const advance = nextLevelAdvance({
+            level,
+            experience,
+            growthRate: progressionFor(speciesId).growthRate,
+        });
+        if (advance === null)
+            return;
+        level = advance.level;
+        experience = advance.experience;
+        stores.pokemon.setLevel(pokemon.id, level, experience);
+        for (const move of movesAtLevel(speciesId, level)) {
+            learnMove(stores, { trainerId, pokemonId: pokemon.id, move, createdAt, createId });
+        }
+    }
+}
+//# sourceMappingURL=resolve-progression.js.map

package/dist/application/use-cases/resolve-progression.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve-progression.js","sourceRoot":"","sources":["../../../src/application/use-cases/resolve-progression.ts"],"names":[],"mappings":"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"}

package/dist/application/use-cases/travel.d.ts

@@ -0,0 +1,7 @@
+import type { LocationTravelResult, RegionTravelResult } from "../contracts/game.js";
+import { type GameCommandDependencies } from "./game-command-support.js";
+export declare function createTravelCommands(dependencies: GameCommandDependencies): {
+    travelTo: (locationId: string) => LocationTravelResult;
+    travelToRegion: (regionId: string) => RegionTravelResult;
+};
+//# sourceMappingURL=travel.d.ts.map

package/dist/application/use-cases/travel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"travel.d.ts","sourceRoot":"","sources":["../../../src/application/use-cases/travel.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,oBAAoB,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAA;AACpF,OAAO,EAEL,KAAK,uBAAuB,EAE7B,MAAM,2BAA2B,CAAA;AAElC,wBAAgB,oBAAoB,CAAC,YAAY,EAAE,uBAAuB;2BAC1C,MAAM,KAAG,oBAAoB;+BAgBzB,MAAM,KAAG,kBAAkB;EAwC9D"}

package/dist/application/use-cases/travel.js

@@ -0,0 +1,58 @@
+import { findLocation, locationsForRegion } from "../../domain/content/catalog.js";
+import { locationTravelEligibility, regionTravelEligibility, } from "../../domain/exploration/exploration.js";
+import { afterGameTransaction, resumeSavedExperienceIfUnblocked, } from "./game-command-support.js";
+export function createTravelCommands(dependencies) {
+    const travelTo = (locationId) => afterGameTransaction(dependencies, (stores) => {
+        const trainer = stores.trainers.find();
+        if (trainer === null)
+            return "inactive";
+        const location = findLocation(locationId);
+        const locationExists = location !== null;
+        if (locationTravelEligibility({ locationExists, unlocked: false }) === "invalid-location")
+            return "invalid-location";
+        const unlocked = stores.commands.exploration.locationUnlocked(trainer.id, locationId);
+        if (locationTravelEligibility({ locationExists, unlocked }) === "locked-location")
+            return "locked-location";
+        if (location === null)
+            return "invalid-location";
+        stores.commands.exploration.travelToLocation(trainer.id, location.regionId, locationId);
+        return "teleported";
+    });
+    const travelToRegion = (regionId) => afterGameTransaction(dependencies, (stores) => {
+        const trainer = stores.trainers.find();
+        if (trainer === null)
+            return "inactive";
+        const firstLocation = locationsForRegion(regionId)[0];
+        // Validate the target before checking progression and visit eligibility.
+        if (firstLocation === undefined)
+            return "invalid-region";
+        const currentRegionComplete = stores.commands.exploration.regionCompleted(trainer.id, trainer.regionId);
+        if (regionTravelEligibility({
+            regionExists: true,
+            currentRegionComplete,
+            targetAlreadyVisited: false,
+        }) === "region-incomplete")
+            return "region-incomplete";
+        const targetAlreadyVisited = stores.commands.exploration.regionVisited(trainer.id, regionId);
+        const eligibility = regionTravelEligibility({
+            regionExists: true,
+            currentRegionComplete,
+            targetAlreadyVisited,
+        });
+        if (eligibility === "already-visited")
+            return "already-visited";
+        stores.commands.exploration.initializeRegion(trainer.id, regionId, firstLocation.id);
+        stores.commands.choices.deleteKind(trainer.id, "region");
+        stores.choices.insert({
+            id: dependencies.createId(),
+            trainerId: trainer.id,
+            kind: "starter",
+            payload: { region: regionId },
+            createdAt: dependencies.now(),
+        });
+        resumeSavedExperienceIfUnblocked(dependencies, stores, trainer.id, regionId);
+        return "traveled";
+    });
+    return { travelTo, travelToRegion };
+}
+//# sourceMappingURL=travel.js.map

package/dist/application/use-cases/travel.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"travel.js","sourceRoot":"","sources":["../../../src/application/use-cases/travel.ts"],"names":[],"mappings":"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"}

package/dist/cli/command.d.ts

@@ -0,0 +1,16 @@
+import { type CommandExecutor } from "./install.js";
+declare const PACKAGE_NAME = "@sbugallo/pokecode";
+export type PackageManifest = Readonly<{
+    name: typeof PACKAGE_NAME;
+    version: string;
+}>;
+export type CliDependencies = Readonly<{
+    readPackageManifest?: () => Promise<PackageManifest>;
+    execute?: CommandExecutor;
+    writeOut?: (text: string) => void;
+    writeError?: (text: string) => void;
+}>;
+export declare function readPackageManifestAt(packageManifestUrl: URL): Promise<PackageManifest>;
+export declare function runCli(arguments_: readonly string[], dependencies?: CliDependencies): Promise<number>;
+export {};
+//# sourceMappingURL=command.d.ts.map

package/dist/cli/command.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"command.d.ts","sourceRoot":"","sources":["../../src/cli/command.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,eAAe,EAAuB,MAAM,cAAc,CAAA;AAExE,QAAA,MAAM,YAAY,uBAAuB,CAAA;AAczC,MAAM,MAAM,eAAe,GAAG,QAAQ,CAAC;IAAE,IAAI,EAAE,OAAO,YAAY,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC,CAAA;AAEtF,MAAM,MAAM,eAAe,GAAG,QAAQ,CAAC;IACrC,mBAAmB,CAAC,EAAE,MAAM,OAAO,CAAC,eAAe,CAAC,CAAA;IACpD,OAAO,CAAC,EAAE,eAAe,CAAA;IACzB,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAA;IACjC,UAAU,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAA;CACpC,CAAC,CAAA;AAcF,wBAAsB,qBAAqB,CAAC,kBAAkB,EAAE,GAAG,GAAG,OAAO,CAAC,eAAe,CAAC,CAO7F;AAeD,wBAAsB,MAAM,CAC1B,UAAU,EAAE,SAAS,MAAM,EAAE,EAC7B,YAAY,GAAE,eAAoB,GACjC,OAAO,CAAC,MAAM,CAAC,CA+BjB"}

package/dist/cli/command.js

@@ -0,0 +1,73 @@
+import { readFile } from "node:fs/promises";
+import { installGlobalPlugin } from "./install.js";
+const PACKAGE_NAME = "@sbugallo/pokecode";
+const EXACT_SEMVER = /^(?:0|[1-9]\d*)\.(?:0|[1-9]\d*)\.(?:0|[1-9]\d*)(?:-(?:0|[1-9]\d*|\d*[A-Za-z-][0-9A-Za-z-]*)(?:\.(?:0|[1-9]\d*|\d*[A-Za-z-][0-9A-Za-z-]*))*)?(?:\+[0-9A-Za-z-]+(?:\.[0-9A-Za-z-]+)*)?$/;
+const HELP = `Usage: npx ${PACKAGE_NAME} init [--dry-run]
+
+Commands:
+  init       Install this package version through OpenCode's global plugin manager.
+
+Options:
+  --dry-run  Show the native OpenCode command without running it.
+  --help     Show this help text.
+`;
+function isPackageManifest(value) {
+    if (typeof value !== "object" || value === null || Array.isArray(value))
+        return false;
+    if (!("name" in value) || !("version" in value))
+        return false;
+    const { name, version } = value;
+    return name === PACKAGE_NAME && typeof version === "string" && EXACT_SEMVER.test(version);
+}
+export async function readPackageManifestAt(packageManifestUrl) {
+    const source = await readFile(packageManifestUrl, "utf8");
+    const manifest = JSON.parse(source);
+    if (!isPackageManifest(manifest)) {
+        throw new Error("Invalid PokéCode package manifest.");
+    }
+    return manifest;
+}
+function parseArguments(arguments_) {
+    if (arguments_.length === 1 && arguments_[0] === "--help")
+        return { kind: "help" };
+    const [command, ...options] = arguments_;
+    if (command !== "init") {
+        return { kind: "invalid", message: "Expected init." };
+    }
+    if (options.length === 0)
+        return { kind: "command", command, dryRun: false };
+    if (options.length === 1 && options[0] === "--dry-run") {
+        return { kind: "command", command, dryRun: true };
+    }
+    return { kind: "invalid", message: "Only --dry-run is supported after a command." };
+}
+export async function runCli(arguments_, dependencies = {}) {
+    const writeOut = dependencies.writeOut ?? ((text) => process.stdout.write(text));
+    const writeError = dependencies.writeError ?? ((text) => process.stderr.write(text));
+    const parsed = parseArguments(arguments_);
+    if (parsed.kind === "help") {
+        writeOut(HELP);
+        return 0;
+    }
+    if (parsed.kind === "invalid") {
+        writeError(`${parsed.message}\n\n${HELP}`);
+        return 2;
+    }
+    const readManifest = dependencies.readPackageManifest;
+    if (readManifest === undefined) {
+        throw new Error("The CLI composition root must provide its package manifest location.");
+    }
+    const manifest = await readManifest();
+    if (!isPackageManifest(manifest)) {
+        throw new Error("Invalid PokéCode package manifest.");
+    }
+    const packageSpec = `${manifest.name}@${manifest.version}`;
+    if (parsed.dryRun) {
+        writeOut(`opencode plugin add ${packageSpec}\n`);
+        return 0;
+    }
+    await installGlobalPlugin(packageSpec, dependencies.execute);
+    writeOut("OpenCode plugin installation completed. Restart OpenCode.\n");
+    return 0;
+}
+//# sourceMappingURL=command.js.map

package/dist/cli/command.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"command.js","sourceRoot":"","sources":["../../src/cli/command.ts"],"names":[],"mappings":"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"}

package/dist/cli/install.d.ts

@@ -0,0 +1,9 @@
+export declare class OpenCodePluginInstallError extends Error {
+    readonly exitCode: number | null;
+    readonly name = "OpenCodePluginInstallError";
+    constructor(exitCode: number | null);
+}
+export type CommandExecutor = (command: string, arguments_: readonly string[]) => Promise<void>;
+export declare const runCommand: CommandExecutor;
+export declare const installGlobalPlugin: (packageSpec: string, execute?: CommandExecutor) => Promise<void>;
+//# sourceMappingURL=install.d.ts.map

package/dist/cli/install.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"install.d.ts","sourceRoot":"","sources":["../../src/cli/install.ts"],"names":[],"mappings":"AAEA,qBAAa,0BAA2B,SAAQ,KAAK;IAGvC,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;IAF5C,QAAQ,CAAC,IAAI,gCAA+B;gBAEvB,QAAQ,EAAE,MAAM,GAAG,IAAI;CAO7C;AAED,MAAM,MAAM,eAAe,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,SAAS,MAAM,EAAE,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;AAE/F,eAAO,MAAM,UAAU,EAAE,eAQrB,CAAA;AAEJ,eAAO,MAAM,mBAAmB,GAC9B,aAAa,MAAM,EACnB,UAAS,eAA4B,KACpC,OAAO,CAAC,IAAI,CAAwD,CAAA"}

package/dist/cli/install.js

@@ -0,0 +1,23 @@
+import { spawn } from "node:child_process";
+export class OpenCodePluginInstallError extends Error {
+    exitCode;
+    name = "OpenCodePluginInstallError";
+    constructor(exitCode) {
+        super(exitCode === null
+            ? "OpenCode plugin installer exited without a status."
+            : `OpenCode plugin installer exited with status ${exitCode}.`);
+        this.exitCode = exitCode;
+    }
+}
+export const runCommand = (command, arguments_) => new Promise((resolve, reject) => {
+    const child = spawn(command, arguments_, { shell: false, stdio: "inherit" });
+    child.once("error", reject);
+    child.once("close", (exitCode) => {
+        if (exitCode === 0)
+            resolve();
+        else
+            reject(new OpenCodePluginInstallError(exitCode));
+    });
+});
+export const installGlobalPlugin = async (packageSpec, execute = runCommand) => execute("opencode", ["plugin", "add", packageSpec]);
+//# sourceMappingURL=install.js.map

package/dist/cli/install.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"install.js","sourceRoot":"","sources":["../../src/cli/install.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAA;AAE1C,MAAM,OAAO,0BAA2B,SAAQ,KAAK;IAG9B;IAFZ,IAAI,GAAG,4BAA4B,CAAA;IAE5C,YAAqB,QAAuB;QAC1C,KAAK,CACH,QAAQ,KAAK,IAAI;YACf,CAAC,CAAC,oDAAoD;YACtD,CAAC,CAAC,gDAAgD,QAAQ,GAAG,CAChE,CAAA;QALkB,aAAQ,GAAR,QAAQ,CAAe;IAM5C,CAAC;CACF;AAID,MAAM,CAAC,MAAM,UAAU,GAAoB,CAAC,OAAO,EAAE,UAAU,EAAE,EAAE,CACjE,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;IAC9B,MAAM,KAAK,GAAG,KAAK,CAAC,OAAO,EAAE,UAAU,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC,CAAA;IAC5E,KAAK,CAAC,IAAI,CAAC,OAAO,EAAE,MAAM,CAAC,CAAA;IAC3B,KAAK,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE,EAAE;QAC/B,IAAI,QAAQ,KAAK,CAAC;YAAE,OAAO,EAAE,CAAA;;YACxB,MAAM,CAAC,IAAI,0BAA0B,CAAC,QAAQ,CAAC,CAAC,CAAA;IACvD,CAAC,CAAC,CAAA;AACJ,CAAC,CAAC,CAAA;AAEJ,MAAM,CAAC,MAAM,mBAAmB,GAAG,KAAK,EACtC,WAAmB,EACnB,UAA2B,UAAU,EACtB,EAAE,CAAC,OAAO,CAAC,UAAU,EAAE,CAAC,QAAQ,EAAE,KAAK,EAAE,WAAW,CAAC,CAAC,CAAA"}

package/dist/cli.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":""}

package/dist/cli.js

@@ -0,0 +1,124 @@
+#!/usr/bin/env node
+// @bun
+
+// src/cli.ts
+import { realpathSync } from "fs";
+import { resolve } from "path";
+import { fileURLToPath } from "url";
+
+// src/cli/command.ts
+import { readFile } from "fs/promises";
+
+// src/cli/install.ts
+import { spawn } from "child_process";
+
+class OpenCodePluginInstallError extends Error {
+  exitCode;
+  name = "OpenCodePluginInstallError";
+  constructor(exitCode) {
+    super(exitCode === null ? "OpenCode plugin installer exited without a status." : `OpenCode plugin installer exited with status ${exitCode}.`);
+    this.exitCode = exitCode;
+  }
+}
+var runCommand = (command, arguments_) => new Promise((resolve, reject) => {
+  const child = spawn(command, arguments_, { shell: false, stdio: "inherit" });
+  child.once("error", reject);
+  child.once("close", (exitCode) => {
+    if (exitCode === 0)
+      resolve();
+    else
+      reject(new OpenCodePluginInstallError(exitCode));
+  });
+});
+var installGlobalPlugin = async (packageSpec, execute = runCommand) => execute("opencode", ["plugin", "add", packageSpec]);
+
+// src/cli/command.ts
+var PACKAGE_NAME = "@sbugallo/pokecode";
+var EXACT_SEMVER = /^(?:0|[1-9]\d*)\.(?:0|[1-9]\d*)\.(?:0|[1-9]\d*)(?:-(?:0|[1-9]\d*|\d*[A-Za-z-][0-9A-Za-z-]*)(?:\.(?:0|[1-9]\d*|\d*[A-Za-z-][0-9A-Za-z-]*))*)?(?:\+[0-9A-Za-z-]+(?:\.[0-9A-Za-z-]+)*)?$/;
+var HELP = `Usage: npx ${PACKAGE_NAME} init [--dry-run]
+
+Commands:
+  init       Install this package version through OpenCode's global plugin manager.
+
+Options:
+  --dry-run  Show the native OpenCode command without running it.
+  --help     Show this help text.
+`;
+function isPackageManifest(value) {
+  if (typeof value !== "object" || value === null || Array.isArray(value))
+    return false;
+  if (!("name" in value) || !("version" in value))
+    return false;
+  const { name, version } = value;
+  return name === PACKAGE_NAME && typeof version === "string" && EXACT_SEMVER.test(version);
+}
+async function readPackageManifestAt(packageManifestUrl) {
+  const source = await readFile(packageManifestUrl, "utf8");
+  const manifest = JSON.parse(source);
+  if (!isPackageManifest(manifest)) {
+    throw new Error("Invalid Pok\xE9Code package manifest.");
+  }
+  return manifest;
+}
+function parseArguments(arguments_) {
+  if (arguments_.length === 1 && arguments_[0] === "--help")
+    return { kind: "help" };
+  const [command, ...options] = arguments_;
+  if (command !== "init") {
+    return { kind: "invalid", message: "Expected init." };
+  }
+  if (options.length === 0)
+    return { kind: "command", command, dryRun: false };
+  if (options.length === 1 && options[0] === "--dry-run") {
+    return { kind: "command", command, dryRun: true };
+  }
+  return { kind: "invalid", message: "Only --dry-run is supported after a command." };
+}
+async function runCli(arguments_, dependencies = {}) {
+  const writeOut = dependencies.writeOut ?? ((text) => process.stdout.write(text));
+  const writeError = dependencies.writeError ?? ((text) => process.stderr.write(text));
+  const parsed = parseArguments(arguments_);
+  if (parsed.kind === "help") {
+    writeOut(HELP);
+    return 0;
+  }
+  if (parsed.kind === "invalid") {
+    writeError(`${parsed.message}
+
+${HELP}`);
+    return 2;
+  }
+  const readManifest = dependencies.readPackageManifest;
+  if (readManifest === undefined) {
+    throw new Error("The CLI composition root must provide its package manifest location.");
+  }
+  const manifest = await readManifest();
+  if (!isPackageManifest(manifest)) {
+    throw new Error("Invalid Pok\xE9Code package manifest.");
+  }
+  const packageSpec = `${manifest.name}@${manifest.version}`;
+  if (parsed.dryRun) {
+    writeOut(`opencode plugin add ${packageSpec}
+`);
+    return 0;
+  }
+  await installGlobalPlugin(packageSpec, dependencies.execute);
+  writeOut(`OpenCode plugin installation completed. Restart OpenCode.
+`);
+  return 0;
+}
+
+// src/cli.ts
+var invokedPath = process.argv[1];
+if (invokedPath !== undefined && realpathSync(resolve(invokedPath)) === realpathSync(fileURLToPath(import.meta.url))) {
+  runCli(process.argv.slice(2), {
+    readPackageManifest: () => readPackageManifestAt(new URL("../package.json", import.meta.url))
+  }).then((exitCode) => {
+    process.exitCode = exitCode;
+  }, (error) => {
+    const message = error instanceof Error ? error.message : "Unexpected CLI failure.";
+    process.stderr.write(`${message}
+`);
+    process.exitCode = 1;
+  });
+}

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAA;AACtC,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AACnC,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAA;AACxC,OAAO,EAAE,qBAAqB,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAA;AAEhE,MAAM,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;AACnC,IACE,WAAW,KAAK,SAAS;IACzB,YAAY,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC,KAAK,YAAY,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EACnF,CAAC;IACD,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE;QAC5B,mBAAmB,EAAE,GAAG,EAAE,CAAC,qBAAqB,CAAC,IAAI,GAAG,CAAC,iBAAiB,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;KAC9F,CAAC,CAAC,IAAI,CACL,CAAC,QAAQ,EAAE,EAAE;QACX,OAAO,CAAC,QAAQ,GAAG,QAAQ,CAAA;IAC7B,CAAC,EACD,CAAC,KAAc,EAAE,EAAE;QACjB,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,yBAAyB,CAAA;QAClF,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,OAAO,IAAI,CAAC,CAAA;QACpC,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAA;IACtB,CAAC,CACF,CAAA;AACH,CAAC"}

package/dist/domain/choices/choices.d.ts

@@ -0,0 +1,79 @@
+import { z } from "zod";
+export declare const moveChoicePayloadSchema: z.ZodObject<{
+    pokemonId: z.ZodString;
+    move: z.ZodObject<{
+        id: z.ZodString;
+        name: z.ZodString;
+    }, z.core.$strip>;
+}, z.core.$strip>;
+export declare const evolutionChoiceOptionsSchema: z.ZodArray<z.ZodObject<{
+    speciesId: z.ZodString;
+    name: z.ZodString;
+}, z.core.$strip>>;
+export declare const evolutionChoicePayloadSchema: z.ZodObject<{
+    pokemonId: z.ZodString;
+    options: z.ZodArray<z.ZodObject<{
+        speciesId: z.ZodString;
+        name: z.ZodString;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+/** Keep the source Pokémon identity alongside its available evolutions. */
+export declare const evolutionChoiceProjectionSchema: z.ZodObject<{
+    pokemonId: z.ZodString;
+    options: z.ZodArray<z.ZodObject<{
+        speciesId: z.ZodString;
+        name: z.ZodString;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export declare const regionChoicePayloadSchema: z.ZodObject<{
+    region: z.ZodString;
+}, z.core.$strip>;
+export declare const starterChoicePayloadSchema: z.ZodObject<{
+    region: z.ZodString;
+}, z.core.$strip>;
+export declare const catchChoicePayloadSchema: z.ZodObject<{
+    encounterId: z.ZodString;
+}, z.core.$strict>;
+export declare const choicePayloadSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    kind: z.ZodLiteral<"move">;
+    payload: z.ZodObject<{
+        pokemonId: z.ZodString;
+        move: z.ZodObject<{
+            id: z.ZodString;
+            name: z.ZodString;
+        }, z.core.$strip>;
+    }, z.core.$strip>;
+}, z.core.$strip>, z.ZodObject<{
+    kind: z.ZodLiteral<"evolution">;
+    payload: z.ZodObject<{
+        pokemonId: z.ZodString;
+        options: z.ZodArray<z.ZodObject<{
+            speciesId: z.ZodString;
+            name: z.ZodString;
+        }, z.core.$strip>>;
+    }, z.core.$strip>;
+}, z.core.$strip>, z.ZodObject<{
+    kind: z.ZodLiteral<"region">;
+    payload: z.ZodObject<{
+        region: z.ZodString;
+    }, z.core.$strip>;
+}, z.core.$strip>, z.ZodObject<{
+    kind: z.ZodLiteral<"starter">;
+    payload: z.ZodObject<{
+        region: z.ZodString;
+    }, z.core.$strip>;
+}, z.core.$strip>, z.ZodObject<{
+    kind: z.ZodLiteral<"catch">;
+    payload: z.ZodObject<{
+        encounterId: z.ZodString;
+    }, z.core.$strict>;
+}, z.core.$strip>], "kind">;
+export type DomainChoice = z.infer<typeof choicePayloadSchema>;
+/** Invalid payload shapes return null; corrupt JSON throws instead of hiding save corruption. */
+export declare function decodeChoicePayload(kind: string, payload: string): DomainChoice | null;
+export declare function encodeChoicePayload(choice: DomainChoice): string;
+export declare function decodeMoveChoiceProjection(payload: string): z.infer<typeof moveChoicePayloadSchema> | null;
+export declare function decodeRegionChoiceProjection(payload: string): z.infer<typeof regionChoicePayloadSchema> | null;
+export declare function decodeStarterChoiceProjection(payload: string): z.infer<typeof starterChoicePayloadSchema> | null;
+export declare function decodeEvolutionChoiceProjection(payload: string): z.infer<typeof evolutionChoiceProjectionSchema> | null;
+//# sourceMappingURL=choices.d.ts.map

package/dist/domain/choices/choices.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"choices.d.ts","sourceRoot":"","sources":["../../../src/domain/choices/choices.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAGvB,eAAO,MAAM,uBAAuB;;;;;;iBAGlC,CAAA;AAEF,eAAO,MAAM,4BAA4B;;;kBAEhC,CAAA;AAET,eAAO,MAAM,4BAA4B;;;;;;iBAGvC,CAAA;AACF,2EAA2E;AAC3E,eAAO,MAAM,+BAA+B;;;;;;iBAA+B,CAAA;AAE3E,eAAO,MAAM,yBAAyB;;iBAA0C,CAAA;AAChF,eAAO,MAAM,0BAA0B;;iBAA0C,CAAA;AACjF,eAAO,MAAM,wBAAwB;;kBAAwD,CAAA;AAE7F,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;2BAM9B,CAAA;AACF,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAA;AAE9D,iGAAiG;AACjG,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,YAAY,GAAG,IAAI,CAKtF;AAED,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,YAAY,GAAG,MAAM,CAEhE;AAED,wBAAgB,0BAA0B,CACxC,OAAO,EAAE,MAAM,GACd,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,GAAG,IAAI,CAEhD;AAED,wBAAgB,4BAA4B,CAC1C,OAAO,EAAE,MAAM,GACd,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,GAAG,IAAI,CAElD;AAED,wBAAgB,6BAA6B,CAC3C,OAAO,EAAE,MAAM,GACd,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,GAAG,IAAI,CAEnD;AAED,wBAAgB,+BAA+B,CAC7C,OAAO,EAAE,MAAM,GACd,CAAC,CAAC,KAAK,CAAC,OAAO,+BAA+B,CAAC,GAAG,IAAI,CAExD"}

package/dist/domain/choices/choices.js

@@ -0,0 +1,54 @@
+import { z } from "zod";
+import { moveSchema } from "../pokemon/types.js";
+export const moveChoicePayloadSchema = z.object({
+    pokemonId: z.string().uuid(),
+    move: moveSchema,
+});
+export const evolutionChoiceOptionsSchema = z
+    .array(z.object({ speciesId: z.string().min(1), name: z.string().min(1) }))
+    .min(2);
+export const evolutionChoicePayloadSchema = z.object({
+    pokemonId: z.string().uuid(),
+    options: evolutionChoiceOptionsSchema,
+});
+/** Keep the source Pokémon identity alongside its available evolutions. */
+export const evolutionChoiceProjectionSchema = evolutionChoicePayloadSchema;
+export const regionChoicePayloadSchema = z.object({ region: z.string().min(1) });
+export const starterChoicePayloadSchema = z.object({ region: z.string().min(1) });
+export const catchChoicePayloadSchema = z.object({ encounterId: z.string().uuid() }).strict();
+export const choicePayloadSchema = z.discriminatedUnion("kind", [
+    z.object({ kind: z.literal("move"), payload: moveChoicePayloadSchema }),
+    z.object({ kind: z.literal("evolution"), payload: evolutionChoicePayloadSchema }),
+    z.object({ kind: z.literal("region"), payload: regionChoicePayloadSchema }),
+    z.object({ kind: z.literal("starter"), payload: starterChoicePayloadSchema }),
+    z.object({ kind: z.literal("catch"), payload: catchChoicePayloadSchema }),
+]);
+/** Invalid payload shapes return null; corrupt JSON throws instead of hiding save corruption. */
+export function decodeChoicePayload(kind, payload) {
+    if (!knownChoiceKinds.has(kind))
+        return null;
+    const parsed = JSON.parse(payload);
+    const result = choicePayloadSchema.safeParse({ kind, payload: parsed });
+    return result.success ? result.data : null;
+}
+export function encodeChoicePayload(choice) {
+    return JSON.stringify(choice.payload);
+}
+export function decodeMoveChoiceProjection(payload) {
+    return parsePayload(moveChoicePayloadSchema, payload);
+}
+export function decodeRegionChoiceProjection(payload) {
+    return parsePayload(regionChoicePayloadSchema, payload);
+}
+export function decodeStarterChoiceProjection(payload) {
+    return parsePayload(starterChoicePayloadSchema, payload);
+}
+export function decodeEvolutionChoiceProjection(payload) {
+    return parsePayload(evolutionChoiceProjectionSchema, payload);
+}
+function parsePayload(schema, payload) {
+    const parsed = schema.safeParse(JSON.parse(payload));
+    return parsed.success ? parsed.data : null;
+}
+const knownChoiceKinds = new Set(["move", "evolution", "region", "starter", "catch"]);
+//# sourceMappingURL=choices.js.map

package/dist/domain/choices/choices.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"choices.js","sourceRoot":"","sources":["../../../src/domain/choices/choices.ts"],"names":[],"mappings":"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"}