@ducky7go/ducky-cli 0.0.4 → 0.0.5-dev.2

package/README.md

@@ -1,241 +1,89 @@
 # ducky-cli
 
-A command-line tool for packaging and publishing game mods to NuGet servers. `ducky-cli` brings the functionality of `action-ducky-nuget` GitHub Action to local development environments, enabling game mod developers to package and publish their mods directly from the command line.
+用于将游戏模组打包并发布到 NuGet 服务器和 Steam 创意工坊的命令行工具。
 
-## Features
-
-- **NuGet Packaging**: Create `.nupkg` packages from mod directories
-- **NuGet Publishing**: Publish packages to nuget.org or custom NuGet servers
-- **Validation**: Validate mods against the [NuGet Mod Packaging Specification v1.0](https://github.com/ducky7go/dukcy-package-spec)
-- **Cross-Platform**: Works on Windows, macOS, and Linux
-- **Namespace Design**: Organized commands for future support of other package formats
-
-## Installation
+## 安装
 
 ```bash
 npm install -g ducky-cli
 ```
 
-Or use directly with npx:
+或使用 npx：
 
 ```bash
 npx ducky-cli --help
 ```
 
-## Quick Start
-
-### Package a Mod
+## 快速开始
 
 ```bash
+# NuGet 打包和发布
 ducky nuget pack ./mods/MyMod
-```
-
-This creates a `.nupkg` file in the mod directory.
-
-### Publish to NuGet
-
-```bash
-# Set your API key
-export NUGET_API_KEY=your-api-key
-
-# Push a .nupkg file
-ducky nuget push ./mods/MyMod.1.0.0.nupkg
-
-# Or pack and push in one step
-ducky nuget push ./mods/MyMod --pack
-```
-
-### Validate a Mod
-
-```bash
-ducky nuget validate ./mods/MyMod
-```
-
-## Commands
-
-### `ducky nuget pack`
-
-Package a mod directory into a `.nupkg` file.
-
-```bash
-ducky nuget pack <path> [options]
-```
-
-**Arguments:**
-- `<path>` - Path to the mod directory
-
-**Options:**
-- `-o, --output <path>` - Output directory for the `.nupkg` file (default: same as input)
-- `-v, --verbose` - Enable verbose output
-
-**Example:**
-```bash
-ducky nuget pack ./mods/MyMod -o ./output
-```
-
-### `ducky nuget push`
-
-Publish a `.nupkg` file to a NuGet server.
-
-```bash
-ducky nuget push <path> [options]
-```
-
-**Arguments:**
-- `<path>` - Path to the `.nupkg` file or mod directory (with `--pack`)
-
-**Options:**
-- `-p, --pack` - Package the mod before pushing
-- `-s, --server <url>` - NuGet server URL (default: `https://api.nuget.org/v3/index.json`)
-- `-k, --api-key <key>` - NuGet API key
-- `-o, --output <path>` - Output directory for `.nupkg` file (when using `--pack`)
-- `-v, --verbose` - Enable verbose output
-
-**Examples:**
-```bash
-# Push an existing .nupkg file
 ducky nuget push ./mods/MyMod.1.0.0.nupkg
 
-# Pack and push in one step
-ducky nuget push ./mods/MyMod --pack
-
-# Use a custom NuGet server
-ducky nuget push ./mods/MyMod.1.0.0.nupkg --server https://my-nuget-server.com/v3/index.json
+# Steam 创意工坊发布
+ducky steam push ./mods/MyMod
+ducky steam push ./mods/MyMod --update-description
 ```
 
-### `ducky nuget validate`
+## 文档
 
-Validate a mod directory against the NuGet Mod Packaging Specification.
+- [NuGet 文档](./docs/nuget.md) - 打包和发布到 NuGet 服务器
+- [Steam 文档](./docs/steam.md) - 发布到 Steam 创意工坊
 
-```bash
-ducky nuget validate <path> [options]
-```
-
-**Arguments:**
-- `<path>` - Path to the mod directory
-
-**Options:**
-- `-v, --verbose` - Enable verbose output
-
-**Example:**
-```bash
-ducky nuget validate ./mods/MyMod
-```
-
-## Configuration
-
-Configuration can be provided via:
-1. Command-line flags (highest priority)
-2. Environment variables
-3. Default values (lowest priority)
-
-### Environment Variables
-
-- `NUGET_API_KEY` - API key for NuGet authentication
-- `NUGET_SERVER` - Default NuGet server URL
-- `NUGET_VERBOSE` - Enable verbose output
-
-## Mod Directory Structure
-
-A valid mod directory should contain:
-
-```
-MyMod/
-├── info.ini              # Mod metadata (required)
-├── MyMod.dll             # Main DLL (required, name must match info.ini name field)
-├── preview.png           # Optional preview image
-└── ...other files        # Any other mod files
-```
-
-### info.ini Format
-
-```ini
-name=MyMod
-version=1.0.0
-description=My awesome game mod
-author=Your Name
-projectUrl=https://github.com/yourname/mymod
-license=MIT
-tags=game,mod,example
+## 功能特性
 
-[dependencies]
-OtherMod=1.0.0
-```
-
-**Required fields:**
-- `name` - NuGet package ID (must start with letter or underscore, max 100 chars)
-- `version` - SemVer 2.0 version (e.g., `1.0.0`, `2.1.0-beta`)
-
-**Optional fields:**
-- `description` - Package description
-- `author` - Package author
-- `projectUrl` - Project URL
-- `license` - License identifier
-- `tags` - Comma-separated list of tags
-- `dependencies` - Comma-separated list of dependencies with optional versions
+- **NuGet 打包**：从模组目录创建 `.nupkg` 包
+- **NuGet 发布**：发布到 nuget.org 或自定义 NuGet 服务器
+- **Steam 创意工坊发布**：支持多语言发布模组
+- **验证**：按照打包规范验证模组
+- **跨平台**：支持 Windows、macOS 和 Linux
 
-## Validation Rules
+## 命令概览
 
-The tool validates mods against these rules:
+| 命令 | 描述 |
+|------|------|
+| `ducky nuget pack <path>` | 将模组目录打包为 `.nupkg` |
+| `ducky nuget push <path>` | 发布到 NuGet 服务器 |
+| `ducky nuget validate <path>` | 验证 NuGet 模组 |
+| `ducky steam validate <path>` | 验证 Steam 创意工坊模组 |
+| `ducky steam push <path>` | 发布到 Steam 创意工坊 |
 
-1. **DLL Name Matching**: At least one DLL file must have a base name matching the `name` field in `info.ini`
-2. **SemVer 2.0 Version**: Version must follow semantic versioning 2.0 format
-3. **Valid NuGet ID**: Package name must be a valid NuGet identifier
-4. **Required Fields**: `name` and `version` fields are required
+## 配置
 
-## Examples
-
-### Complete Workflow
+通过环境变量设置：
 
 ```bash
-# 1. Create your mod directory with info.ini and DLL files
-mkdir -p ./mods/MyMod
-
-# 2. Validate your mod
-ducky nuget validate ./mods/MyMod
-
-# 3. Package your mod
-ducky nuget pack ./mods/MyMod
-
-# 4. Publish to NuGet
+# NuGet
 export NUGET_API_KEY=your-api-key
-ducky nuget push ./mods/MyMod.1.0.0.nupkg
-```
+export NUGET_SERVER=https://api.nuget.org/v3/index.json
 
-### Using Custom NuGet Server
-
-```bash
-export NUGET_SERVER=https://my-nuget-server.com/v3/index.json
-export NUGET_API_KEY=your-api-key
-ducky nuget push ./mods/MyMod.1.0.0.nupkg
+# Steam
+export STEAM_APP_ID=3167020
 ```
 
-## Error Handling
-
-The tool provides helpful error messages with suggestions:
+## 模组目录结构
 
 ```
-✖ Invalid version format: 1.0
-
-Suggestions:
-  • Version must follow SemVer 2.0 format
-  • Examples: 1.0.0, 2.1.0-beta, 3.0.0-rc.1
+MyMod/
+├── info.ini              # 模组元数据（必需）
+├── MyMod.dll             # 主 DLL（必需）
+├── preview.png           # 预览图片（Steam 必需）
+├── description/          # 多语言描述（Steam 使用）
+│   ├── en.md
+│   └── zh.md
+└── ...其他文件
 ```
 
-## Contributing
-
-Contributions are welcome! Please read our contributing guidelines before submitting PRs.
-
-## License
+## 许可证
 
-MIT License - see LICENSE file for details
+MIT License - 详见 LICENSE 文件
 
-## Related Projects
+## 相关项目
 
-- [action-ducky-nuget](https://github.com/ducky7go/action-ducky-nuget) - GitHub Action for CI/CD
-- [NuGet Mod Packaging Specification](https://github.com/ducky7go/dukcy-package-spec) - Specification for mod packaging
+- [action-ducky-nuget](https://github.com/ducky7go/action-ducky-nuget) - CI/CD GitHub Action
+- [NuGet 模组打包规范](https://github.com/ducky7go/dukcy-package-spec)
 
-## Support
+## 支持
 
-- Report bugs: [GitHub Issues](https://github.com/ducky7go/ducky-cli/issues)
-- Documentation: [GitHub Wiki](https://github.com/ducky7go/ducky-cli/wiki)
+- 报告问题：[GitHub Issues](https://github.com/ducky7go/ducky-cli/issues)

package/dist/cli.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAIpC,QAAA,MAAM,OAAO,SAAgB,CAAC;AAkB9B,OAAO,EAAE,OAAO,EAAE,CAAC"}
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAKpC,QAAA,MAAM,OAAO,SAAgB,CAAC;AAmB9B,OAAO,EAAE,OAAO,EAAE,CAAC"}

package/dist/cli.js

@@ -1,6 +1,7 @@
 #!/usr/bin/env node
 import { Command } from 'commander';
 import { registerNuGetCommands } from './commands/nuget/index.js';
+import { registerSteamCommands } from './commands/steam/index.js';
 // Create the main program
 const program = new Command();
 program
@@ -9,6 +10,7 @@ program
     .version('0.1.0');
 // Register format namespaces
 registerNuGetCommands(program);
+registerSteamCommands(program);
 // Future formats can be registered here:
 // registerZipCommands(program);
 // registerTarCommands(program);

package/dist/cli.js.map

@@ -1 +1 @@
-{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAC;AAElE,0BAA0B;AAC1B,MAAM,OAAO,GAAG,IAAI,OAAO,EAAE,CAAC;AAE9B,OAAO;KACJ,IAAI,CAAC,OAAO,CAAC;KACb,WAAW,CAAC,iDAAiD,CAAC;KAC9D,OAAO,CAAC,OAAO,CAAC,CAAC;AAEpB,6BAA6B;AAC7B,qBAAqB,CAAC,OAAO,CAAC,CAAC;AAE/B,yCAAyC;AACzC,gCAAgC;AAChC,gCAAgC;AAEhC,kBAAkB;AAClB,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;AAE5B,qBAAqB;AACrB,OAAO,EAAE,OAAO,EAAE,CAAC"}
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAC;AAClE,OAAO,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAC;AAElE,0BAA0B;AAC1B,MAAM,OAAO,GAAG,IAAI,OAAO,EAAE,CAAC;AAE9B,OAAO;KACJ,IAAI,CAAC,OAAO,CAAC;KACb,WAAW,CAAC,iDAAiD,CAAC;KAC9D,OAAO,CAAC,OAAO,CAAC,CAAC;AAEpB,6BAA6B;AAC7B,qBAAqB,CAAC,OAAO,CAAC,CAAC;AAC/B,qBAAqB,CAAC,OAAO,CAAC,CAAC;AAE/B,yCAAyC;AACzC,gCAAgC;AAChC,gCAAgC;AAEhC,kBAAkB;AAClB,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;AAE5B,qBAAqB;AACrB,OAAO,EAAE,OAAO,EAAE,CAAC"}

package/dist/commands/steam/index.d.ts

@@ -0,0 +1,3 @@
+import { Command } from 'commander';
+export declare function registerSteamCommands(program: Command): void;
+//# sourceMappingURL=index.d.ts.map

package/dist/commands/steam/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/commands/steam/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAIpC,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAqB5D"}

package/dist/commands/steam/index.js

@@ -0,0 +1,21 @@
+import { Command } from 'commander';
+import { steamValidateCommand } from './validate.js';
+import { steamPushCommand } from './push.js';
+export function registerSteamCommands(program) {
+    // Create the steam namespace command
+    const steamCommand = new Command('steam')
+        .description('Steam Workshop publishing commands')
+        .addHelpText('beforeAll', `
+Steam commands for publishing game mods to Steam Workshop.
+
+Examples:
+  $ ducky steam validate ./mods/MyMod
+  $ ducky steam push ./mods/MyMod
+  $ ducky steam push ./mods/MyMod --update-description --changelog "Fixed bugs"
+`);
+    // Register subcommands
+    steamCommand.addCommand(steamValidateCommand);
+    steamCommand.addCommand(steamPushCommand);
+    program.addCommand(steamCommand);
+}
+//# sourceMappingURL=index.js.map

package/dist/commands/steam/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/commands/steam/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC;AACrD,OAAO,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAE7C,MAAM,UAAU,qBAAqB,CAAC,OAAgB;IACpD,qCAAqC;IACrC,MAAM,YAAY,GAAG,IAAI,OAAO,CAAC,OAAO,CAAC;SACtC,WAAW,CAAC,oCAAoC,CAAC;SACjD,WAAW,CACV,WAAW,EACX;;;;;;;CAOL,CACI,CAAC;IAEJ,uBAAuB;IACvB,YAAY,CAAC,UAAU,CAAC,oBAAoB,CAAC,CAAC;IAC9C,YAAY,CAAC,UAAU,CAAC,gBAAgB,CAAC,CAAC;IAE1C,OAAO,CAAC,UAAU,CAAC,YAAY,CAAC,CAAC;AACnC,CAAC"}

package/dist/commands/steam/push.d.ts

@@ -0,0 +1,3 @@
+import { Command } from 'commander';
+export declare const steamPushCommand: Command;
+//# sourceMappingURL=push.d.ts.map

package/dist/commands/steam/push.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"push.d.ts","sourceRoot":"","sources":["../../../src/commands/steam/push.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAIpC,eAAO,MAAM,gBAAgB,SAyBzB,CAAC"}

package/dist/commands/steam/push.js

@@ -0,0 +1,29 @@
+import { Command } from 'commander';
+import { createLogger } from '../../utils/logger.js';
+import { steamPushAction } from '../../formats/steam/push-handler.js';
+export const steamPushCommand = new Command('push')
+    .description('Push mod to Steam Workshop')
+    .argument('<path>', 'Path to the mod directory')
+    .option('--update-description', 'Update Workshop descriptions from description/*.md files', false)
+    .option('--changelog <note>', 'Update changelog notes for this update')
+    .option('--skip-tail', 'Skip appending submission footer to description and changelog', false)
+    .option('-v, --verbose', 'Enable verbose output', false)
+    .action(async (path, options) => {
+    const logger = createLogger({ verbose: options.verbose });
+    logger.header('Steam Workshop Publish');
+    try {
+        await steamPushAction(path, {
+            updateDescription: options.updateDescription,
+            changelog: options.changelog,
+            skipTail: options.skipTail,
+            logger,
+        });
+        logger.success('Mod published to Steam Workshop successfully!');
+        process.exit(0);
+    }
+    catch (error) {
+        logger.error(error);
+        process.exit(1);
+    }
+});
+//# sourceMappingURL=push.js.map

package/dist/commands/steam/push.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"push.js","sourceRoot":"","sources":["../../../src/commands/steam/push.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AACrD,OAAO,EAAE,eAAe,EAAE,MAAM,qCAAqC,CAAC;AAEtE,MAAM,CAAC,MAAM,gBAAgB,GAAG,IAAI,OAAO,CAAC,MAAM,CAAC;KAChD,WAAW,CAAC,4BAA4B,CAAC;KACzC,QAAQ,CAAC,QAAQ,EAAE,2BAA2B,CAAC;KAC/C,MAAM,CAAC,sBAAsB,EAAE,0DAA0D,EAAE,KAAK,CAAC;KACjG,MAAM,CAAC,oBAAoB,EAAE,wCAAwC,CAAC;KACtE,MAAM,CAAC,aAAa,EAAE,+DAA+D,EAAE,KAAK,CAAC;KAC7F,MAAM,CAAC,eAAe,EAAE,uBAAuB,EAAE,KAAK,CAAC;KACvD,MAAM,CAAC,KAAK,EAAE,IAAY,EAAE,OAAgG,EAAE,EAAE;IAC/H,MAAM,MAAM,GAAG,YAAY,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC;IAC1D,MAAM,CAAC,MAAM,CAAC,wBAAwB,CAAC,CAAC;IAExC,IAAI,CAAC;QACH,MAAM,eAAe,CAAC,IAAI,EAAE;YAC1B,iBAAiB,EAAE,OAAO,CAAC,iBAAiB;YAC5C,SAAS,EAAE,OAAO,CAAC,SAAS;YAC5B,QAAQ,EAAE,OAAO,CAAC,QAAQ;YAC1B,MAAM;SACP,CAAC,CAAC;QAEH,MAAM,CAAC,OAAO,CAAC,+CAA+C,CAAC,CAAC;QAChE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,CAAC,KAAK,CAAC,KAAuB,CAAC,CAAC;QACtC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;AACH,CAAC,CAAC,CAAC"}

package/dist/commands/steam/validate.d.ts

@@ -0,0 +1,3 @@
+import { Command } from 'commander';
+export declare const steamValidateCommand: Command;
+//# sourceMappingURL=validate.d.ts.map

package/dist/commands/steam/validate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate.d.ts","sourceRoot":"","sources":["../../../src/commands/steam/validate.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAKpC,eAAO,MAAM,oBAAoB,SA6C7B,CAAC"}

package/dist/commands/steam/validate.js

@@ -0,0 +1,47 @@
+import { Command } from 'commander';
+import { createLogger } from '../../utils/logger.js';
+import { SteamValidator } from '../../formats/steam/validator.js';
+import { getSteamAppId } from '../../formats/steam/config.js';
+export const steamValidateCommand = new Command('validate')
+    .description('Validate Steam Workshop publishing configuration')
+    .argument('<path>', 'Path to the mod directory')
+    .option('-v, --verbose', 'Enable verbose output', false)
+    .action(async (path, options) => {
+    const logger = createLogger({ verbose: options.verbose });
+    logger.header('Steam Workshop Validation');
+    try {
+        const validator = new SteamValidator(logger);
+        // Get Steam App ID
+        const appId = getSteamAppId();
+        logger.info(`Using Steam App ID: ${appId}`);
+        // Run validation
+        const result = await validator.validate(path);
+        // Display results
+        if (result.isValid) {
+            logger.success('All validations passed!');
+            logger.blank();
+            logger.info('Your mod is ready to publish to Steam Workshop.');
+        }
+        else {
+            logger.error('Validation failed:');
+            logger.blank();
+            for (const error of result.errors) {
+                logger.error(error.message);
+                if (error.suggestions && error.suggestions.length > 0) {
+                    logger.blank();
+                    logger.info('Suggestions:');
+                    for (const suggestion of error.suggestions) {
+                        console.log(`  • ${suggestion}`);
+                    }
+                }
+                logger.blank();
+            }
+            process.exit(1);
+        }
+    }
+    catch (error) {
+        logger.error(error);
+        process.exit(1);
+    }
+});
+//# sourceMappingURL=validate.js.map

package/dist/commands/steam/validate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate.js","sourceRoot":"","sources":["../../../src/commands/steam/validate.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AACrD,OAAO,EAAE,cAAc,EAAE,MAAM,kCAAkC,CAAC;AAClE,OAAO,EAAE,aAAa,EAAE,MAAM,+BAA+B,CAAC;AAE9D,MAAM,CAAC,MAAM,oBAAoB,GAAG,IAAI,OAAO,CAAC,UAAU,CAAC;KACxD,WAAW,CAAC,kDAAkD,CAAC;KAC/D,QAAQ,CAAC,QAAQ,EAAE,2BAA2B,CAAC;KAC/C,MAAM,CAAC,eAAe,EAAE,uBAAuB,EAAE,KAAK,CAAC;KACvD,MAAM,CAAC,KAAK,EAAE,IAAY,EAAE,OAA6B,EAAE,EAAE;IAC5D,MAAM,MAAM,GAAG,YAAY,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC;IAC1D,MAAM,CAAC,MAAM,CAAC,2BAA2B,CAAC,CAAC;IAE3C,IAAI,CAAC;QACH,MAAM,SAAS,GAAG,IAAI,cAAc,CAAC,MAAM,CAAC,CAAC;QAE7C,mBAAmB;QACnB,MAAM,KAAK,GAAG,aAAa,EAAE,CAAC;QAC9B,MAAM,CAAC,IAAI,CAAC,uBAAuB,KAAK,EAAE,CAAC,CAAC;QAE5C,iBAAiB;QACjB,MAAM,MAAM,GAAG,MAAM,SAAS,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;QAE9C,kBAAkB;QAClB,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;YACnB,MAAM,CAAC,OAAO,CAAC,yBAAyB,CAAC,CAAC;YAC1C,MAAM,CAAC,KAAK,EAAE,CAAC;YACf,MAAM,CAAC,IAAI,CAAC,iDAAiD,CAAC,CAAC;QACjE,CAAC;aAAM,CAAC;YACN,MAAM,CAAC,KAAK,CAAC,oBAAoB,CAAC,CAAC;YACnC,MAAM,CAAC,KAAK,EAAE,CAAC;YAEf,KAAK,MAAM,KAAK,IAAI,MAAM,CAAC,MAAM,EAAE,CAAC;gBAClC,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;gBAC5B,IAAI,KAAK,CAAC,WAAW,IAAI,KAAK,CAAC,WAAW,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;oBACtD,MAAM,CAAC,KAAK,EAAE,CAAC;oBACf,MAAM,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;oBAC5B,KAAK,MAAM,UAAU,IAAI,KAAK,CAAC,WAAW,EAAE,CAAC;wBAC3C,OAAO,CAAC,GAAG,CAAC,OAAO,UAAU,EAAE,CAAC,CAAC;oBACnC,CAAC;gBACH,CAAC;gBACD,MAAM,CAAC,KAAK,EAAE,CAAC;YACjB,CAAC;YAED,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;IACH,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,CAAC,KAAK,CAAC,KAAuB,CAAC,CAAC;QACtC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;AACH,CAAC,CAAC,CAAC"}

package/dist/formats/steam/config.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Steam configuration
+ *
+ * App ID is fixed at 3167020 and can only be overridden via environment variable.
+ * It cannot be added to info.ini.
+ */
+/**
+ * Get Steam App ID from environment variable or use default
+ * @returns Steam App ID
+ */
+export declare function getSteamAppId(): number;
+/**
+ * Steam configuration interface
+ */
+export interface SteamConfig {
+    appId: number;
+}
+/**
+ * Get Steam configuration
+ * @returns Steam configuration
+ */
+export declare function getSteamConfig(): SteamConfig;
+//# sourceMappingURL=config.d.ts.map

package/dist/formats/steam/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../../src/formats/steam/config.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH;;;GAGG;AACH,wBAAgB,aAAa,IAAI,MAAM,CAUtC;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;;GAGG;AACH,wBAAgB,cAAc,IAAI,WAAW,CAI5C"}

package/dist/formats/steam/config.js

@@ -0,0 +1,32 @@
+/**
+ * Steam configuration
+ *
+ * App ID is fixed at 3167020 and can only be overridden via environment variable.
+ * It cannot be added to info.ini.
+ */
+const DEFAULT_STEAM_APP_ID = 3167020;
+/**
+ * Get Steam App ID from environment variable or use default
+ * @returns Steam App ID
+ */
+export function getSteamAppId() {
+    const envAppId = process.env.STEAM_APP_ID;
+    if (envAppId) {
+        const appId = parseInt(envAppId, 10);
+        if (isNaN(appId)) {
+            throw new Error(`Invalid STEAM_APP_ID environment variable: ${envAppId}`);
+        }
+        return appId;
+    }
+    return DEFAULT_STEAM_APP_ID;
+}
+/**
+ * Get Steam configuration
+ * @returns Steam configuration
+ */
+export function getSteamConfig() {
+    return {
+        appId: getSteamAppId(),
+    };
+}
+//# sourceMappingURL=config.js.map

package/dist/formats/steam/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../../src/formats/steam/config.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,MAAM,oBAAoB,GAAG,OAAO,CAAC;AAErC;;;GAGG;AACH,MAAM,UAAU,aAAa;IAC3B,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,YAAY,CAAC;IAC1C,IAAI,QAAQ,EAAE,CAAC;QACb,MAAM,KAAK,GAAG,QAAQ,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;QACrC,IAAI,KAAK,CAAC,KAAK,CAAC,EAAE,CAAC;YACjB,MAAM,IAAI,KAAK,CAAC,8CAA8C,QAAQ,EAAE,CAAC,CAAC;QAC5E,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;IACD,OAAO,oBAAoB,CAAC;AAC9B,CAAC;AASD;;;GAGG;AACH,MAAM,UAAU,cAAc;IAC5B,OAAO;QACL,KAAK,EAAE,aAAa,EAAE;KACvB,CAAC;AACJ,CAAC"}

package/dist/formats/steam/metadata.d.ts

@@ -0,0 +1,45 @@
+/**
+ * Localized description
+ */
+export interface LocalizedDescription {
+    language: string;
+    content: string;
+}
+/**
+ * Localized title
+ */
+export interface LocalizedTitle {
+    language: string;
+    title: string;
+}
+/**
+ * Map filename to Steam language code
+ * @param filename - The filename without extension (e.g., "zh", "en", "japanese")
+ * @returns Steam language code or null if not found
+ */
+export declare function mapFilenameToLanguage(filename: string): string | null;
+/**
+ * Load descriptions from description/*.md files
+ * @param directory - Path to the mod directory
+ * @returns Array of localized descriptions
+ */
+export declare function loadDescriptions(directory: string): Promise<LocalizedDescription[]>;
+/**
+ * Load titles from description/*.md files
+ * @param directory - Path to the mod directory
+ * @param defaultTitle - The default title to use if no title is found in a file
+ * @returns Array of localized titles
+ */
+export declare function loadTitles(directory: string, defaultTitle: string): Promise<LocalizedTitle[]>;
+/**
+ * Get the primary language description and title
+ * Priority: english -> schinese -> first available
+ * @param descriptions - Array of localized descriptions
+ * @param titles - Array of localized titles
+ * @returns Primary description and title
+ */
+export declare function getPrimaryLanguageContent(descriptions: LocalizedDescription[], titles: LocalizedTitle[]): {
+    description?: LocalizedDescription;
+    title?: LocalizedTitle;
+};
+//# sourceMappingURL=metadata.d.ts.map

package/dist/formats/steam/metadata.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"metadata.d.ts","sourceRoot":"","sources":["../../../src/formats/steam/metadata.ts"],"names":[],"mappings":"AAGA;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;CACf;AAiID;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAGrE;AAgGD;;;;GAIG;AACH,wBAAsB,gBAAgB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,oBAAoB,EAAE,CAAC,CAyCzF;AAED;;;;;GAKG;AACH,wBAAsB,UAAU,CAC9B,SAAS,EAAE,MAAM,EACjB,YAAY,EAAE,MAAM,GACnB,OAAO,CAAC,cAAc,EAAE,CAAC,CAyC3B;AAED;;;;;;GAMG;AACH,wBAAgB,yBAAyB,CACvC,YAAY,EAAE,oBAAoB,EAAE,EACpC,MAAM,EAAE,cAAc,EAAE,GACvB;IAAE,WAAW,CAAC,EAAE,oBAAoB,CAAC;IAAC,KAAK,CAAC,EAAE,cAAc,CAAA;CAAE,CAoBhE"}