@victorrl/semantic-release-godot 1.0.1

package/README.md

@@ -0,0 +1,83 @@
+# `@victorrl/semantic-release-godot`
+
+`semantic-release` plugin to automate version and build number injection for Godot 4 projects, specifically targeting Android and global game configurations.
+
+The plugin runs during the semantic-release `prepare` lifecycle, ensuring that version numbers are baked into project files before your build/export stage and before the release is tagged in Git.
+
+---
+
+## How It Works
+
+This plugin automates three common versioning techniques in Godot 4:
+
+### 1. Android Preset Options (`export_presets.cfg`)
+Bakes the user-facing version name and unique build code into the Android preset options before you trigger `godot --export-release`.
+- **`version/name`**: Set to the next release version (e.g., `"1.0.1"`).
+- **`version/code`**: Set to a strictly increasing integer. By default, it computes the **total git commit count** (`git rev-list --count HEAD`) to use as the build number. You can also specify an offset or override this manually.
+
+### 2. Custom Global Config (Approach A - `project.godot`)
+By default, this is enabled and writes/updates the game version inside `project.godot` (default key is `config/version` under `[application]`).
+You can read this at runtime in GDScript:
+```gdscript
+var game_version = ProjectSettings.get_setting("application/config/version")
+```
+
+### 3. Autoload Script Constant (Approach B - GDScript)
+Optionally updates a specific version constant (default name `GAME_VERSION`) in an Autoload script (e.g. `res://scripts/Version.gd`):
+```gdscript
+extends Node
+const GAME_VERSION = "1.0.1"
+```
+
+---
+
+## Install
+
+```sh
+npm install --save-dev @victorrl/semantic-release-godot
+```
+
+## Usage
+
+Configure the plugin in your `release.config.js` or `.releaserc`:
+
+```js
+export default {
+  plugins: [
+    "@semantic-release/commit-analyzer",
+    "@semantic-release/release-notes-generator",
+    [
+      "@victorrl/semantic-release-godot",
+      {
+        // By default, Approach A is enabled, Approach B is disabled
+        enableApproachA: true,
+        enableApproachB: true,
+        gdScriptPath: "res://scripts/Version.gd"
+      }
+    ],
+    "@semantic-release/github"
+  ]
+};
+```
+
+---
+
+## Configuration Options
+
+| Option | Env Fallback | Default | Description |
+|---|---|---|---|
+| `exportPresetsPath` | `GODOT_EXPORT_PRESETS_PATH` | `export_presets.cfg` | Path to your Godot export configuration file. |
+| `projectGodotPath` | `GODOT_PROJECT_GODOT_PATH` | `project.godot` | Path to your `project.godot` file. |
+| `enableApproachA` | `GODOT_ENABLE_APPROACH_A` | `true` | Update the version inside `project.godot`. |
+| `projectVersionKey` | `GODOT_PROJECT_VERSION_KEY` | `config/version` | The key under `[application]` to write the version to in `project.godot`. |
+| `enableApproachB` | `GODOT_ENABLE_APPROACH_B` | `false` | Update a version constant inside a GDScript file. |
+| `gdScriptPath` | `GODOT_GDSCRIPT_PATH` | `null` | Path to the GDScript file (supports `res://` prefix). Required if `enableApproachB` is `true`. |
+| `gdScriptVersionConstant` | `GODOT_GDSCRIPT_VERSION_CONSTANT` | `GAME_VERSION` | The variable/constant name in the GDScript to update. |
+| `versionCode` | `GODOT_VERSION_CODE` | `null` | Manual version code value. If not specified, git commit count is used. |
+| `versionCodeOffset` | `GODOT_VERSION_CODE_OFFSET` | `0` | Offset added to the computed git commit count version code. |
+
+---
+
+## License
+
+MIT

package/dist/error.d.ts

@@ -0,0 +1,8 @@
+export declare class GodotPluginError extends Error {
+    readonly code: string;
+    readonly details?: string | undefined;
+    readonly name = "SemanticReleaseError";
+    readonly semanticRelease = true;
+    constructor(code: string, message: string, details?: string | undefined);
+}
+//# sourceMappingURL=error.d.ts.map

package/dist/error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"error.d.ts","sourceRoot":"","sources":["../src/error.ts"],"names":[],"mappings":"AAAA,qBAAa,gBAAiB,SAAQ,KAAK;aAKzB,IAAI,EAAE,MAAM;aAEZ,OAAO,CAAC,EAAE,MAAM;IANjC,SAAyB,IAAI,0BAA0B;IACvD,SAAgB,eAAe,QAAQ;gBAGtB,IAAI,EAAE,MAAM,EAC5B,OAAO,EAAE,MAAM,EACC,OAAO,CAAC,EAAE,MAAM,YAAA;CAIjC"}

package/dist/error.js

@@ -0,0 +1,12 @@
+export class GodotPluginError extends Error {
+    code;
+    details;
+    name = "SemanticReleaseError";
+    semanticRelease = true;
+    constructor(code, message, details) {
+        super(message);
+        this.code = code;
+        this.details = details;
+    }
+}
+//# sourceMappingURL=error.js.map

package/dist/error.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"error.js","sourceRoot":"","sources":["../src/error.ts"],"names":[],"mappings":"AAAA,MAAM,OAAO,gBAAiB,SAAQ,KAAK;IAKzB;IAEA;IANQ,IAAI,GAAG,sBAAsB,CAAC;IACvC,eAAe,GAAG,IAAI,CAAC;IAEvC,YACiB,IAAY,EAC5B,OAAe,EACC,OAAgB;QAEhC,KAAK,CAAC,OAAO,CAAC,CAAC;QAJC,SAAI,GAAJ,IAAI,CAAQ;QAEZ,YAAO,GAAP,OAAO,CAAS;IAGjC,CAAC;CACD"}

package/dist/index.d.ts

@@ -0,0 +1,21 @@
+import type { PrepareContext, VerifyConditionsContext } from "semantic-release";
+import { type GodotPluginOptions } from "./options.js";
+export type { GodotPluginOptions };
+interface Line {
+    type: "empty" | "comment" | "keyvalue" | "unknown";
+    key?: string;
+    value?: string;
+    raw: string;
+}
+interface Section {
+    name: string;
+    lines: Line[];
+}
+export declare function parseGodotConfig(content: string): Section[];
+export declare function stringifyGodotConfig(sections: Section[]): string;
+export declare function updateExportPresets(content: string, versionName: string, versionCode: number): string;
+export declare function updateProjectGodot(content: string, versionName: string, versionKey?: string): string;
+export declare function updateGDScript(content: string, versionName: string, constantName?: string): string;
+export declare function verifyConditions(pluginConfig: GodotPluginOptions, context: VerifyConditionsContext): Promise<void>;
+export declare function prepare(pluginConfig: GodotPluginOptions, context: PrepareContext): Promise<void>;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,cAAc,EAAE,uBAAuB,EAAE,MAAM,kBAAkB,CAAC;AAEhF,OAAO,EAAE,KAAK,kBAAkB,EAAsB,MAAM,cAAc,CAAC;AAI3E,YAAY,EAAE,kBAAkB,EAAE,CAAC;AAEnC,UAAU,IAAI;IACb,IAAI,EAAE,OAAO,GAAG,SAAS,GAAG,UAAU,GAAG,SAAS,CAAC;IACnD,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;CACZ;AAED,UAAU,OAAO;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,IAAI,EAAE,CAAC;CACd;AAED,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,EAAE,CAyC3D;AAED,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,OAAO,EAAE,GAAG,MAAM,CAehE;AAED,wBAAgB,mBAAmB,CAClC,OAAO,EAAE,MAAM,EACf,WAAW,EAAE,MAAM,EACnB,WAAW,EAAE,MAAM,GACjB,MAAM,CA6DR;AAED,wBAAgB,kBAAkB,CACjC,OAAO,EAAE,MAAM,EACf,WAAW,EAAE,MAAM,EACnB,UAAU,SAAmB,GAC3B,MAAM,CAuBR;AAED,wBAAgB,cAAc,CAC7B,OAAO,EAAE,MAAM,EACf,WAAW,EAAE,MAAM,EACnB,YAAY,SAAiB,GAC3B,MAAM,CAYR;AAwBD,wBAAsB,gBAAgB,CACrC,YAAY,EAAE,kBAAkB,EAChC,OAAO,EAAE,uBAAuB,GAC9B,OAAO,CAAC,IAAI,CAAC,CAwDf;AAED,wBAAsB,OAAO,CAC5B,YAAY,EAAE,kBAAkB,EAChC,OAAO,EAAE,cAAc,GACrB,OAAO,CAAC,IAAI,CAAC,CA2Df"}

package/dist/index.js

@@ -0,0 +1,232 @@
+import { execFile } from "node:child_process";
+import { access, readFile, writeFile } from "node:fs/promises";
+import { resolve } from "node:path";
+import { promisify } from "node:util";
+import { GodotPluginError } from "./error.js";
+import { resolveGodotConfig } from "./options.js";
+const execFileAsync = promisify(execFile);
+export function parseGodotConfig(content) {
+    const lines = content.split(/\r?\n/);
+    const sections = [];
+    let currentSection = { name: "", lines: [] };
+    sections.push(currentSection);
+    for (const line of lines) {
+        const trimmed = line.trim();
+        if (trimmed.startsWith("[") && trimmed.endsWith("]")) {
+            const name = trimmed.slice(1, -1);
+            currentSection = { name, lines: [] };
+            sections.push(currentSection);
+            continue;
+        }
+        if (trimmed === "") {
+            currentSection.lines.push({ type: "empty", raw: line });
+            continue;
+        }
+        if (trimmed.startsWith(";")) {
+            currentSection.lines.push({ type: "comment", raw: line });
+            continue;
+        }
+        const equalIndex = line.indexOf("=");
+        if (equalIndex !== -1) {
+            const key = line.slice(0, equalIndex).trim();
+            const value = line.slice(equalIndex + 1).trim();
+            currentSection.lines.push({
+                type: "keyvalue",
+                key,
+                value,
+                raw: line,
+            });
+        }
+        else {
+            currentSection.lines.push({ type: "unknown", raw: line });
+        }
+    }
+    return sections;
+}
+export function stringifyGodotConfig(sections) {
+    const output = [];
+    for (const section of sections) {
+        if (section.name !== "") {
+            output.push(`[${section.name}]`);
+        }
+        for (const line of section.lines) {
+            if (line.type === "keyvalue") {
+                output.push(`${line.key}=${line.value}`);
+            }
+            else {
+                output.push(line.raw);
+            }
+        }
+    }
+    return output.join("\n");
+}
+export function updateExportPresets(content, versionName, versionCode) {
+    const sections = parseGodotConfig(content);
+    // Find all preset indices that are Android
+    const androidPresets = new Set();
+    for (const section of sections) {
+        const match = section.name.match(/^preset\.(\d+)$/);
+        if (match) {
+            const index = match[1];
+            if (index) {
+                const platformLine = section.lines.find((l) => l.type === "keyvalue" && l.key === "platform");
+                if (platformLine?.value === '"Android"') {
+                    androidPresets.add(index);
+                }
+            }
+        }
+    }
+    // Update options sections for those presets
+    for (const index of androidPresets) {
+        const optionsSectionName = `preset.${index}.options`;
+        let optionsSection = sections.find((s) => s.name === optionsSectionName);
+        if (!optionsSection) {
+            optionsSection = { name: optionsSectionName, lines: [] };
+            sections.push(optionsSection);
+        }
+        // Update or add version/code
+        const codeLine = optionsSection.lines.find((l) => l.type === "keyvalue" && l.key === "version/code");
+        if (codeLine) {
+            codeLine.value = String(versionCode);
+        }
+        else {
+            optionsSection.lines.push({
+                type: "keyvalue",
+                key: "version/code",
+                value: String(versionCode),
+                raw: `version/code=${versionCode}`,
+            });
+        }
+        // Update or add version/name
+        const nameLine = optionsSection.lines.find((l) => l.type === "keyvalue" && l.key === "version/name");
+        if (nameLine) {
+            nameLine.value = `"${versionName}"`;
+        }
+        else {
+            optionsSection.lines.push({
+                type: "keyvalue",
+                key: "version/name",
+                value: `"${versionName}"`,
+                raw: `version/name="${versionName}"`,
+            });
+        }
+    }
+    return stringifyGodotConfig(sections);
+}
+export function updateProjectGodot(content, versionName, versionKey = "config/version") {
+    const sections = parseGodotConfig(content);
+    let appSection = sections.find((s) => s.name === "application");
+    if (!appSection) {
+        appSection = { name: "application", lines: [] };
+        sections.push(appSection);
+    }
+    const versionLine = appSection.lines.find((l) => l.type === "keyvalue" && l.key === versionKey);
+    if (versionLine) {
+        versionLine.value = `"${versionName}"`;
+    }
+    else {
+        appSection.lines.push({
+            type: "keyvalue",
+            key: versionKey,
+            value: `"${versionName}"`,
+            raw: `${versionKey}="${versionName}"`,
+        });
+    }
+    return stringifyGodotConfig(sections);
+}
+export function updateGDScript(content, versionName, constantName = "GAME_VERSION") {
+    const regex = new RegExp(`(${constantName}(?:\\s*:\\s*\\w+)?\\s*=\\s*["'])([^"']*)(["'])`);
+    if (!regex.test(content)) {
+        throw new GodotPluginError("EGDSCRIPTCONSTANTNOTFOUND", `semantic-release-godot: Could not find version constant "${constantName}" in script.`, "Verify the constant exists in the GDScript file and is assigned a string value.");
+    }
+    return content.replace(regex, `$1${versionName}$3`);
+}
+const resolveScriptPath = (path, cwd) => {
+    const cleanPath = path.startsWith("res://") ? path.slice(6) : path;
+    return resolve(cwd, cleanPath);
+};
+const getCommitCount = async (cwd) => {
+    try {
+        const { stdout } = await execFileAsync("git", ["rev-list", "--count", "HEAD"], { cwd });
+        return Number.parseInt(stdout.trim(), 10);
+    }
+    catch (err) {
+        throw new GodotPluginError("EGITCOMMITCOUNT", "semantic-release-godot: Failed to determine git commit count.", err instanceof Error ? err.message : String(err));
+    }
+};
+export async function verifyConditions(pluginConfig, context) {
+    const config = resolveGodotConfig(pluginConfig, context.env);
+    const cwd = context.cwd ?? process.cwd();
+    // 1. Verify git is available if versionCode is computed
+    if (config.versionCode === null) {
+        try {
+            await execFileAsync("git", ["--version"], { cwd });
+        }
+        catch (err) {
+            throw new GodotPluginError("EGITNOTFOUND", "semantic-release-godot: git must be installed to compute versionCode.", err instanceof Error ? err.message : String(err));
+        }
+    }
+    // 2. Verify export_presets.cfg exists
+    const presetsPath = resolve(cwd, config.exportPresetsPath);
+    try {
+        await access(presetsPath);
+    }
+    catch {
+        throw new GodotPluginError("EMISSINGEXPORTPRESETS", `semantic-release-godot: export_presets.cfg not found at "${presetsPath}".`, "Make sure export_presets.cfg exists in your project repository.");
+    }
+    // 3. If Approach A is enabled, verify project.godot exists
+    if (config.enableApproachA) {
+        const projectGodotPath = resolve(cwd, config.projectGodotPath);
+        try {
+            await access(projectGodotPath);
+        }
+        catch {
+            throw new GodotPluginError("EMISSINGPROJECTGODOT", `semantic-release-godot: project.godot not found at "${projectGodotPath}".`, "Approach A is enabled by default. Set enableApproachA to false if you do not want to use it.");
+        }
+    }
+    // 4. If Approach B is enabled, verify gdScriptPath exists
+    if (config.enableApproachB && config.gdScriptPath) {
+        const scriptPath = resolveScriptPath(config.gdScriptPath, cwd);
+        try {
+            await access(scriptPath);
+        }
+        catch {
+            throw new GodotPluginError("EMISSINGGDSCRIPT", `semantic-release-godot: GDScript file not found at "${scriptPath}".`, "Make sure the gdScriptPath option matches an existing file in your repository.");
+        }
+    }
+}
+export async function prepare(pluginConfig, context) {
+    const config = resolveGodotConfig(pluginConfig, context.env);
+    const cwd = context.cwd ?? process.cwd();
+    // 1. Calculate version code
+    let code = config.versionCode;
+    if (code === null) {
+        const commitCount = await getCommitCount(cwd);
+        code = commitCount + config.versionCodeOffset;
+    }
+    const versionName = context.nextRelease.version;
+    // 2. Update export_presets.cfg
+    const presetsPath = resolve(cwd, config.exportPresetsPath);
+    const presetsContent = await readFile(presetsPath, "utf8");
+    const updatedPresetsContent = updateExportPresets(presetsContent, versionName, code);
+    await writeFile(presetsPath, updatedPresetsContent, "utf8");
+    context.logger.log(`[semantic-release-godot] Updated Android preset options in "${config.exportPresetsPath}" with version/name="${versionName}" and version/code=${code}`);
+    // 3. If Approach A is enabled, update project.godot
+    if (config.enableApproachA) {
+        const projectGodotPath = resolve(cwd, config.projectGodotPath);
+        const projectGodotContent = await readFile(projectGodotPath, "utf8");
+        const updatedProjectGodotContent = updateProjectGodot(projectGodotContent, versionName, config.projectVersionKey);
+        await writeFile(projectGodotPath, updatedProjectGodotContent, "utf8");
+        context.logger.log(`[semantic-release-godot] Updated "${config.projectGodotPath}" [application] ${config.projectVersionKey} to "${versionName}"`);
+    }
+    // 4. If Approach B is enabled, update GDScript file
+    if (config.enableApproachB && config.gdScriptPath) {
+        const scriptPath = resolveScriptPath(config.gdScriptPath, cwd);
+        const scriptContent = await readFile(scriptPath, "utf8");
+        const updatedScriptContent = updateGDScript(scriptContent, versionName, config.gdScriptVersionConstant);
+        await writeFile(scriptPath, updatedScriptContent, "utf8");
+        context.logger.log(`[semantic-release-godot] Updated GDScript constant "${config.gdScriptVersionConstant}" in "${config.gdScriptPath}" to "${versionName}"`);
+    }
+    context.logger.success("[semantic-release-godot] Successfully injected version info!");
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/options.d.ts

@@ -0,0 +1,24 @@
+export interface GodotPluginOptions {
+    readonly exportPresetsPath?: string;
+    readonly projectGodotPath?: string;
+    readonly enableApproachA?: boolean;
+    readonly projectVersionKey?: string;
+    readonly enableApproachB?: boolean;
+    readonly gdScriptPath?: string;
+    readonly gdScriptVersionConstant?: string;
+    readonly versionCode?: number;
+    readonly versionCodeOffset?: number;
+}
+export interface ResolvedGodotPluginConfig {
+    readonly exportPresetsPath: string;
+    readonly projectGodotPath: string;
+    readonly enableApproachA: boolean;
+    readonly projectVersionKey: string;
+    readonly enableApproachB: boolean;
+    readonly gdScriptPath: string | null;
+    readonly gdScriptVersionConstant: string;
+    readonly versionCode: number | null;
+    readonly versionCodeOffset: number;
+}
+export declare function resolveGodotConfig(pluginConfig: GodotPluginOptions, env: Readonly<Record<string, string | undefined>>): ResolvedGodotPluginConfig;
+//# sourceMappingURL=options.d.ts.map

package/dist/options.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"options.d.ts","sourceRoot":"","sources":["../src/options.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,kBAAkB;IAClC,QAAQ,CAAC,iBAAiB,CAAC,EAAE,MAAM,CAAC;IACpC,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IACnC,QAAQ,CAAC,eAAe,CAAC,EAAE,OAAO,CAAC;IACnC,QAAQ,CAAC,iBAAiB,CAAC,EAAE,MAAM,CAAC;IACpC,QAAQ,CAAC,eAAe,CAAC,EAAE,OAAO,CAAC;IACnC,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,uBAAuB,CAAC,EAAE,MAAM,CAAC;IAC1C,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,iBAAiB,CAAC,EAAE,MAAM,CAAC;CACpC;AAED,MAAM,WAAW,yBAAyB;IACzC,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAC;IACnC,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,eAAe,EAAE,OAAO,CAAC;IAClC,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAC;IACnC,QAAQ,CAAC,eAAe,EAAE,OAAO,CAAC;IAClC,QAAQ,CAAC,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IACrC,QAAQ,CAAC,uBAAuB,EAAE,MAAM,CAAC;IACzC,QAAQ,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IACpC,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAC;CACnC;AA2BD,wBAAgB,kBAAkB,CACjC,YAAY,EAAE,kBAAkB,EAChC,GAAG,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC,GAC/C,yBAAyB,CA2D3B"}

package/dist/options.js

@@ -0,0 +1,59 @@
+import { GodotPluginError } from "./error.js";
+const parseBoolean = (name, value, defaultValue) => {
+    if (value === undefined) {
+        return defaultValue;
+    }
+    if (typeof value === "boolean") {
+        return value;
+    }
+    const normalized = value.trim().toLowerCase();
+    if (["true", "1", "yes"].includes(normalized)) {
+        return true;
+    }
+    if (["false", "0", "no"].includes(normalized)) {
+        return false;
+    }
+    throw new GodotPluginError("EINVALIDBOOLEAN", `semantic-release-godot: ${name} must be a boolean.`, `Use true/false for ${name}.`);
+};
+export function resolveGodotConfig(pluginConfig, env) {
+    const enableApproachA = parseBoolean("enableApproachA", pluginConfig.enableApproachA ?? env.GODOT_ENABLE_APPROACH_A, true);
+    const enableApproachB = parseBoolean("enableApproachB", pluginConfig.enableApproachB ?? env.GODOT_ENABLE_APPROACH_B, false);
+    const gdScriptPath = pluginConfig.gdScriptPath || env.GODOT_GDSCRIPT_PATH || null;
+    if (enableApproachB && !gdScriptPath) {
+        throw new GodotPluginError("EMISSINGGDSCRIPTPATH", "semantic-release-godot: gdScriptPath is required when enableApproachB is true.", "Set gdScriptPath in plugin options or GODOT_GDSCRIPT_PATH environment variable.");
+    }
+    let versionCodeRaw = null;
+    if (pluginConfig.versionCode !== undefined) {
+        versionCodeRaw = pluginConfig.versionCode;
+    }
+    else if (env.GODOT_VERSION_CODE) {
+        versionCodeRaw = Number.parseInt(env.GODOT_VERSION_CODE, 10);
+    }
+    let versionCodeOffset = 0;
+    if (pluginConfig.versionCodeOffset !== undefined) {
+        versionCodeOffset = pluginConfig.versionCodeOffset;
+    }
+    else if (env.GODOT_VERSION_CODE_OFFSET) {
+        versionCodeOffset = Number.parseInt(env.GODOT_VERSION_CODE_OFFSET, 10);
+    }
+    return {
+        exportPresetsPath: pluginConfig.exportPresetsPath ||
+            env.GODOT_EXPORT_PRESETS_PATH ||
+            "export_presets.cfg",
+        projectGodotPath: pluginConfig.projectGodotPath ||
+            env.GODOT_PROJECT_GODOT_PATH ||
+            "project.godot",
+        enableApproachA,
+        projectVersionKey: pluginConfig.projectVersionKey ||
+            env.GODOT_PROJECT_VERSION_KEY ||
+            "config/version",
+        enableApproachB,
+        gdScriptPath,
+        gdScriptVersionConstant: pluginConfig.gdScriptVersionConstant ||
+            env.GODOT_GDSCRIPT_VERSION_CONSTANT ||
+            "GAME_VERSION",
+        versionCode: versionCodeRaw,
+        versionCodeOffset,
+    };
+}
+//# sourceMappingURL=options.js.map

package/dist/options.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"options.js","sourceRoot":"","sources":["../src/options.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AA0B9C,MAAM,YAAY,GAAG,CACpB,IAAY,EACZ,KAAmC,EACnC,YAAqB,EACX,EAAE;IACZ,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;QACzB,OAAO,YAAY,CAAC;IACrB,CAAC;IACD,IAAI,OAAO,KAAK,KAAK,SAAS,EAAE,CAAC;QAChC,OAAO,KAAK,CAAC;IACd,CAAC;IACD,MAAM,UAAU,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IAC9C,IAAI,CAAC,MAAM,EAAE,GAAG,EAAE,KAAK,CAAC,CAAC,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC;QAC/C,OAAO,IAAI,CAAC;IACb,CAAC;IACD,IAAI,CAAC,OAAO,EAAE,GAAG,EAAE,IAAI,CAAC,CAAC,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC;QAC/C,OAAO,KAAK,CAAC;IACd,CAAC;IACD,MAAM,IAAI,gBAAgB,CACzB,iBAAiB,EACjB,2BAA2B,IAAI,qBAAqB,EACpD,sBAAsB,IAAI,GAAG,CAC7B,CAAC;AACH,CAAC,CAAC;AAEF,MAAM,UAAU,kBAAkB,CACjC,YAAgC,EAChC,GAAiD;IAEjD,MAAM,eAAe,GAAG,YAAY,CACnC,iBAAiB,EACjB,YAAY,CAAC,eAAe,IAAI,GAAG,CAAC,uBAAuB,EAC3D,IAAI,CACJ,CAAC;IACF,MAAM,eAAe,GAAG,YAAY,CACnC,iBAAiB,EACjB,YAAY,CAAC,eAAe,IAAI,GAAG,CAAC,uBAAuB,EAC3D,KAAK,CACL,CAAC;IAEF,MAAM,YAAY,GACjB,YAAY,CAAC,YAAY,IAAI,GAAG,CAAC,mBAAmB,IAAI,IAAI,CAAC;IAC9D,IAAI,eAAe,IAAI,CAAC,YAAY,EAAE,CAAC;QACtC,MAAM,IAAI,gBAAgB,CACzB,sBAAsB,EACtB,gFAAgF,EAChF,iFAAiF,CACjF,CAAC;IACH,CAAC;IAED,IAAI,cAAc,GAAkB,IAAI,CAAC;IACzC,IAAI,YAAY,CAAC,WAAW,KAAK,SAAS,EAAE,CAAC;QAC5C,cAAc,GAAG,YAAY,CAAC,WAAW,CAAC;IAC3C,CAAC;SAAM,IAAI,GAAG,CAAC,kBAAkB,EAAE,CAAC;QACnC,cAAc,GAAG,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,kBAAkB,EAAE,EAAE,CAAC,CAAC;IAC9D,CAAC;IAED,IAAI,iBAAiB,GAAG,CAAC,CAAC;IAC1B,IAAI,YAAY,CAAC,iBAAiB,KAAK,SAAS,EAAE,CAAC;QAClD,iBAAiB,GAAG,YAAY,CAAC,iBAAiB,CAAC;IACpD,CAAC;SAAM,IAAI,GAAG,CAAC,yBAAyB,EAAE,CAAC;QAC1C,iBAAiB,GAAG,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,yBAAyB,EAAE,EAAE,CAAC,CAAC;IACxE,CAAC;IAED,OAAO;QACN,iBAAiB,EAChB,YAAY,CAAC,iBAAiB;YAC9B,GAAG,CAAC,yBAAyB;YAC7B,oBAAoB;QACrB,gBAAgB,EACf,YAAY,CAAC,gBAAgB;YAC7B,GAAG,CAAC,wBAAwB;YAC5B,eAAe;QAChB,eAAe;QACf,iBAAiB,EAChB,YAAY,CAAC,iBAAiB;YAC9B,GAAG,CAAC,yBAAyB;YAC7B,gBAAgB;QACjB,eAAe;QACf,YAAY;QACZ,uBAAuB,EACtB,YAAY,CAAC,uBAAuB;YACpC,GAAG,CAAC,+BAA+B;YACnC,cAAc;QACf,WAAW,EAAE,cAAc;QAC3B,iBAAiB;KACjB,CAAC;AACH,CAAC"}

package/docs/index.md

@@ -0,0 +1,13 @@
+# Godot 4 semantic-release plugin
+
+This plugin automates the injection of version names and build codes for Godot 4 games during the `prepare` phase of the release pipeline.
+
+## Features
+
+- **Android Export Versioning (`export_presets.cfg`)**: Automatically updates or adds `version/name` and `version/code` configuration properties.
+- **Approach A (`project.godot`)**: Updates the application config version string so the game can read it dynamically at runtime.
+- **Approach B (GDScript Autoload)**: Performs regex-based substitution of a version constant in a GDScript file.
+
+## Lifecycle Placement
+
+The version changes are written locally during the `prepare` step, allowing subsequent steps in your pipeline (like exporting/compiling via the Godot CLI, or committing changed files back to Git) to have access to the exact release version.

package/examples/README.md

@@ -0,0 +1,7 @@
+# Examples
+
+These examples show how to configure `@victorrl/semantic-release-godot` in a `semantic-release` pipeline.
+
+## Files
+
+- [`semantic-release.config.js`](./semantic-release.config.js): A typical semantic-release plugin chain setup that modifies your Android export presets, `project.godot` file, and an Autoload GDScript file containing a version constant, and then commits the modified files back to Git before creating the release.

package/examples/semantic-release.config.js

@@ -0,0 +1,30 @@
+export default {
+	branches: ["main", { name: "next", prerelease: true }],
+	plugins: [
+		"@semantic-release/commit-analyzer",
+		"@semantic-release/release-notes-generator",
+		[
+			"@victorrl/semantic-release-godot",
+			{
+				exportPresetsPath: "export_presets.cfg",
+				projectGodotPath: "project.godot",
+				enableApproachA: true,
+				enableApproachB: true,
+				gdScriptPath: "res://scripts/Version.gd",
+			},
+		],
+		[
+			"@semantic-release/git",
+			{
+				assets: [
+					"export_presets.cfg",
+					"project.godot",
+					"scripts/Version.gd",
+				],
+				message:
+					"chore(release): ${nextRelease.version} [skip ci]\n\n${nextRelease.notes}",
+			},
+		],
+		"@semantic-release/github",
+	],
+};

package/package.json

@@ -0,0 +1,54 @@
+{
+  "name": "@victorrl/semantic-release-godot",
+  "version": "1.0.1",
+  "publishConfig": {
+    "access": "public"
+  },
+  "description": "semantic-release plugin to automate version and build code injection for Godot 4 projects.",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "docs",
+    "examples",
+    "README.md"
+  ],
+  "engines": {
+    "node": ">=20",
+    "bun": ">=1.2"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "prepack": "npm install --no-audit --no-fund && npm run build",
+    "typecheck": "tsc --noEmit",
+    "lint": "biome check src tests",
+    "lint:fix": "biome check --write src tests",
+    "format": "biome format --write src tests",
+    "format:check": "biome format src tests",
+    "test": "bun test tests",
+    "test:unit": "bun test tests/unit",
+    "test:integration": "bun test tests/integration",
+    "test:coverage": "bun test tests --coverage",
+    "audit": "bun audit"
+  },
+  "peerDependencies": {
+    "semantic-release": ">=24"
+  },
+  "devDependencies": {
+    "@biomejs/biome": "^2.5.0",
+    "@semantic-release/changelog": "^6.0.3",
+    "@semantic-release/git": "^10.0.1",
+    "@types/bun": "^1.3.14",
+    "@types/node": "^20.0.0",
+    "semantic-release": "24.2.0",
+    "typescript": "^5.6.0"
+  }
+}