xcstrings-cli 1.0.0 → 1.1.1

package/README.md

@@ -20,10 +20,6 @@ Check it out here: [xcstrings-cli Helper](https://chatgpt.com/g/g-69365945f8bc81
 1. Install xcstrings-cli using npm:
     ```bash
     npm install -g xcstrings-cli
-    # or
-    yarn global add xcstrings-cli
-    # or
-    pnpm global add xcstrings-cli
     ```
 
 2. Initialize xcstrings-cli

package/package.json

@@ -1,11 +1,16 @@
 {
   "name": "xcstrings-cli",
-  "version": "1.0.0",
+  "version": "1.1.1",
   "description": "A command line tool for handling xcstrings files.",
   "type": "module",
   "bin": {
     "xcstrings": "./dist/index.js"
   },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
   "keywords": [
     "xcstrings",
     "cli",
@@ -25,8 +30,7 @@
     "prettier": "^3.7.4",
     "typescript": "^5.9.3",
     "vite": "^7.2.6",
-    "vitest": "^4.0.15",
-    "yargs": "^18.0.0"
+    "vitest": "^4.0.15"
   },
   "dependencies": {
     "@bacons/xcode": "1.0.0-alpha.27",
@@ -34,7 +38,8 @@
     "chalk": "^5.6.2",
     "cosmiconfig": "^9.0.0",
     "json5": "^2.2.3",
-    "pino": "^8.16.0"
+    "pino": "^8.16.0",
+    "yargs": "^18.0.0"
   },
   "scripts": {
     "dev": "vite",

package/.changeset/README.md

@@ -1,8 +0,0 @@
-# Changesets
-
-Hello and welcome! This folder has been automatically generated by `@changesets/cli`, a build tool that works
-with multi-package repos, or single-package repos to help you version and publish your code. You can
-find the full documentation for it [in our repository](https://github.com/changesets/changesets)
-
-We have a quick list of common questions to get you started engaging with this project in
-[our documentation](https://github.com/changesets/changesets/blob/main/docs/common-questions.md)

package/.changeset/config.json

@@ -1,11 +0,0 @@
-{
-  "$schema": "https://unpkg.com/@changesets/config@3.1.2/schema.json",
-  "changelog": "@changesets/cli/changelog",
-  "commit": false,
-  "fixed": [],
-  "linked": [],
-  "access": "public",
-  "baseBranch": "main",
-  "updateInternalDependencies": "patch",
-  "ignore": []
-}

package/.github/workflows/release.yml

@@ -1,56 +0,0 @@
-name: Release
-
-on:
-  workflow_dispatch:
-  push:
-    branches:
-      - main
-
-concurrency: ${{ github.workflow }}-${{ github.ref }}
-
-permissions:
-  contents: write
-  pull-requests: write
-  id-token: write
-
-jobs:
-  release:
-    name: Release
-    runs-on: ubuntu-latest
-    steps:
-      - name: Checkout repository
-        uses: actions/checkout@v4
-        with:
-          fetch-depth: 0
-
-      - name: Setup pnpm
-        uses: pnpm/action-setup@v4
-        with:
-          version: 10
-
-      - name: Setup Node.js
-        uses: actions/setup-node@v4
-        with:
-          node-version: 20
-          cache: "pnpm"
-          registry-url: "https://registry.npmjs.org"
-
-      - name: Upgrade npm (for OIDC)
-        run: npm install -g npm@latest
-
-      - name: Install dependencies
-        run: pnpm install --frozen-lockfile
-
-      - name: Build packages
-        run: pnpm build
-
-      - name: Create Release Pull Request or Publish
-        id: changesets
-        uses: changesets/action@v1
-        with:
-          version: pnpm changeset version
-          publish: pnpm release
-          title: "chore: version packages"
-          commit: "chore: version packages"
-        env:
-          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}

package/.markdownlint.json

@@ -1,3 +0,0 @@
-{
-    "extends": "markdownlint/style/relaxed"
-}

package/.prettierrc

@@ -1,7 +0,0 @@
-{
-  "semi": true,
-  "singleQuote": true,
-  "trailingComma": "all",
-  "printWidth": 80,
-  "tabWidth": 4,
-}

package/src/commands/_shared.ts

@@ -1,63 +0,0 @@
-import { readFile, writeFile } from 'node:fs/promises';
-
-export interface XCStrings {
-    sourceLanguage: string;
-    strings: Record<string, XCStringUnit>;
-    version?: string;
-}
-
-export interface XCStringUnit {
-    comment?: string;
-    extractionState?: 'manual' | 'migrated' | 'stale' | 'ucheck';
-    localizations?: Record<string, XCStringLocalization>;
-    shouldTranslate?: boolean;
-}
-
-export interface XCStringLocalization {
-    stringUnit: {
-        state: 'translated' | 'needs_review' | 'new';
-        value: string;
-    };
-}
-
-export async function readXCStrings(path: string): Promise<XCStrings> {
-    const content = await readFile(path, 'utf-8');
-    return JSON.parse(content) as XCStrings;
-}
-
-export async function writeXCStrings(path: string, data: XCStrings): Promise<void> {
-    const json = JSON.stringify(data, null, 2);
-    const formatted = formatXCStrings(json);
-    await writeFile(path, formatted + '\n', 'utf-8');
-}
-
-export function formatXCStrings(json: string): string {
-    let result = '';
-    let inString = false;
-    let escape = false;
-
-    for (let i = 0; i < json.length; i++) {
-        const char = json[i];
-        if (inString && char === '\\' && !escape) {
-            escape = true;
-            result += char;
-            continue;
-        }
-        if (escape) {
-            escape = false;
-            result += char;
-            continue;
-        }
-        if (char === '"') {
-            inString = !inString;
-            result += char;
-            continue;
-        }
-        if (!inString && char === ':') {
-            result += ' :';
-            continue;
-        }
-        result += char;
-    }
-    return result;
-}

package/src/commands/add.ts

@@ -1,38 +0,0 @@
-import { readXCStrings, writeXCStrings, XCStringUnit } from './_shared';
-
-export async function add(
-    path: string,
-    key: string,
-    comment: string | undefined,
-    strings: Record<string, string> | undefined,
-): Promise<void> {
-    const data = await readXCStrings(path);
-
-    if (!data.strings) {
-        data.strings = {};
-    }
-
-    const unit: XCStringUnit = {
-        ...data.strings[key],
-        extractionState: 'manual',
-    };
-
-    if (comment) {
-        unit.comment = comment;
-    }
-
-    if (strings) {
-        unit.localizations = unit.localizations || {};
-        for (const [lang, value] of Object.entries(strings)) {
-            unit.localizations[lang] = {
-                stringUnit: {
-                    state: 'translated',
-                    value: value,
-                },
-            };
-        }
-    }
-
-    data.strings[key] = unit;
-    await writeXCStrings(path, data);
-}

package/src/commands/index.ts

@@ -1,5 +0,0 @@
-export { add } from './add';
-export { remove } from './remove';
-export { init } from './init';
-export { languages } from './languages';
-export * from './_shared';

package/src/commands/init.ts

@@ -1,159 +0,0 @@
-import { writeFile, readdir } from 'node:fs/promises';
-import { resolve, relative } from 'node:path';
-import chalk from 'chalk';
-import { checkbox, confirm } from '@inquirer/prompts';
-
-const INIT_FILE_NAME = 'xcstrings-cli.json5';
-
-async function findXCStringsFiles(dir: string): Promise<string[]> {
-    const results: string[] = [];
-
-    async function walk(currentDir: string): Promise<void> {
-        try {
-            const entries = await readdir(currentDir, { withFileTypes: true });
-            for (const entry of entries) {
-                const fullPath = resolve(currentDir, entry.name);
-                if (entry.isDirectory()) {
-                    // Skip node_modules, .git, etc.
-                    if (!entry.name.startsWith('.') && entry.name !== 'node_modules') {
-                        await walk(fullPath);
-                    }
-                } else if (entry.name.endsWith('.xcstrings')) {
-                    results.push(fullPath);
-                }
-            }
-        } catch {
-            // Ignore permission errors
-        }
-    }
-
-    await walk(dir);
-    return results;
-}
-
-async function findXcodeprojDirs(startDir: string): Promise<string[]> {
-    const results: string[] = [];
-    let currentDir = startDir;
-    try {
-        const entries = await readdir(currentDir, { withFileTypes: true });
-        for (const entry of entries) {
-            if (entry.isDirectory() && entry.name.endsWith('.xcodeproj')) {
-                results.push(resolve(currentDir, entry.name));
-            }
-        }
-    } catch {
-        // Ignore permission errors
-    }
-    return results;
-}
-
-export async function init(): Promise<void> {
-    const cwd = process.cwd();
-
-    console.log();
-    console.log(chalk.bold.cyan('🚀 xcstrings-cli Configuration Setup'));
-    console.log(chalk.dim('─'.repeat(40)));
-    console.log();
-
-    console.log(chalk.yellow('🔍 Searching for .xcstrings files...'));
-    const xcstringsFiles = await findXCStringsFiles(cwd);
-
-    console.log(chalk.yellow('🔍 Searching for .xcodeproj directories...'));
-    const xcodeprojDirs = await findXcodeprojDirs(cwd);
-
-    console.log();
-
-    let selectedXCStrings: string[] = [];
-    if (xcstringsFiles.length > 0) {
-        console.log(chalk.green(`✓ Found ${xcstringsFiles.length} .xcstrings file(s)`));
-
-        const choices = xcstringsFiles.map((file) => ({
-            name: chalk.white(relative(cwd, file)) + chalk.dim(` (${file})`),
-            value: relative(cwd, file),
-            checked: true,
-        }));
-
-        selectedXCStrings = await checkbox({
-            message: chalk.bold('Select .xcstrings files to manage:'),
-            choices,
-        });
-    } else {
-        console.log(chalk.dim('  No .xcstrings files found in current directory'));
-    }
-
-    console.log();
-
-    let selectedXcodeproj: string[] = [];
-    if (xcodeprojDirs.length > 0) {
-        console.log(chalk.green(`✓ Found ${xcodeprojDirs.length} .xcodeproj director${xcodeprojDirs.length === 1 ? 'y' : 'ies'}`));
-
-        const choices = xcodeprojDirs.map((dir) => ({
-            name: chalk.white(relative(cwd, dir) || dir) + chalk.dim(` (${dir})`),
-            value: relative(cwd, dir) || dir,
-            checked: true,
-        }));
-
-        selectedXcodeproj = await checkbox({
-            message: chalk.bold('Select .xcodeproj directories for language detection:'),
-            choices,
-        });
-    } else {
-        console.log(chalk.dim('  No .xcodeproj directories found'));
-    }
-
-    console.log();
-    console.log(chalk.dim('─'.repeat(40)));
-    console.log();
-
-    console.log(chalk.bold('📋 Configuration Summary:'));
-    console.log();
-
-    console.log(chalk.cyan('  xcstringsPaths:'));
-    if (selectedXCStrings.length > 0) {
-        selectedXCStrings.forEach((p) => console.log(chalk.white(`    • ${p}`)));
-    } else {
-        console.log(chalk.dim('    (none)'));
-    }
-
-    console.log();
-    console.log(chalk.cyan('  xcodeprojPaths:'));
-    if (selectedXcodeproj.length > 0) {
-        selectedXcodeproj.forEach((p) => console.log(chalk.white(`    • ${p}`)));
-    } else {
-        console.log(chalk.dim('    (none)'));
-    }
-
-    console.log();
-
-    const shouldWrite = await confirm({
-        message: chalk.bold(`Create ${chalk.yellow(INIT_FILE_NAME)}?`),
-        default: true,
-    });
-
-    if (!shouldWrite) {
-        console.log(chalk.dim('  Configuration cancelled.'));
-        return;
-    }
-
-    const xcstringsArray = selectedXCStrings.map((p) => `        "${p}"`).join(',\n');
-    const xcodeprojArray = selectedXcodeproj.map((p) => `        "${p}"`).join(',\n');
-
-    const config = `{
-    // Array of paths to .xcstrings files to manage. Specify relative or absolute paths.
-    xcstringsPaths: [
-${xcstringsArray}
-    ],
-    // Array of paths to .xcodeproj directories. Used for discovering supported languages.
-    xcodeprojPaths: [
-${xcodeprojArray}
-    ]
-}
-`;
-
-    await writeFile(INIT_FILE_NAME, config, 'utf-8');
-
-    console.log();
-    console.log(chalk.bold.green(`✓ Created ${INIT_FILE_NAME}`));
-    console.log(chalk.dim(`   Run ${chalk.cyan('xcstrings --help')} to see available commands.`));
-    console.log();
-}

package/src/commands/languages.ts

@@ -1,43 +0,0 @@
-import { XcodeProject } from '@bacons/xcode';
-import { resolve } from 'node:path';
-import { loadConfig } from '../utils/config';
-import { readXCStrings } from './_shared';
-
-export function getLanguagesFromXcodeproj(xcodeprojPath: string): string[] {
-    const pbxprojPath = resolve(xcodeprojPath, 'project.pbxproj');
-    const project = XcodeProject.open(pbxprojPath);
-    const rootObject = project.rootObject;
-    return rootObject.props.knownRegions ?? [];
-}
-
-export async function getLanguagesFromXCStrings(xcstringsPath: string): Promise<string[]> {
-    const xcstrings = await readXCStrings(xcstringsPath);
-    const languages = new Set<string>();
-
-    for (const key of Object.keys(xcstrings.strings)) {
-        const unit = xcstrings.strings[key];
-        if (unit.localizations) {
-            for (const lang of Object.keys(unit.localizations)) {
-                languages.add(lang);
-            }
-        }
-    }
-
-    return Array.from(languages).sort();
-}
-
-export async function languages(
-    xcstringsPath: string,
-    configPath?: string
-): Promise<string[]> {
-    const config = await loadConfig(configPath);
-    if (config?.xcodeprojPaths && config.xcodeprojPaths.length > 0) {
-        const allLanguages = new Set<string>();
-        for (const xcodeprojPath of config.xcodeprojPaths) {
-            const langs = getLanguagesFromXcodeproj(xcodeprojPath);
-            langs.forEach((lang) => allLanguages.add(lang));
-        }
-        return Array.from(allLanguages).sort();
-    }
-    return await getLanguagesFromXCStrings(xcstringsPath);
-}

package/src/commands/remove.ts

@@ -1,9 +0,0 @@
-import { readXCStrings, writeXCStrings } from './_shared';
-
-export async function remove(path: string, key: string): Promise<void> {
-    const data = await readXCStrings(path);
-    if (data.strings && data.strings[key]) {
-        delete data.strings[key];
-        await writeXCStrings(path, data);
-    }
-}

package/src/index.ts

@@ -1,126 +0,0 @@
-#!/usr/bin/env node
-
-import yargs from 'yargs';
-import { hideBin } from 'yargs/helpers';
-import { remove, init, languages } from './commands/index.js';
-import { resolve } from 'node:path';
-import { loadConfig } from './utils/config.js';
-import logger from './utils/logger.js';
-import { runAddCommand } from './utils/cli.js';
-import { select } from '@inquirer/prompts';
-import chalk from 'chalk';
-
-const defaultPath = resolve(process.cwd(), 'Localizable.xcstrings');
-
-yargs(hideBin(process.argv))
-    .scriptName('xcstrings')
-    .usage('$0 <cmd> [args]')
-    .option('config', {
-        type: 'string',
-        describe: 'Path to config file',
-    })
-    .option('path', {
-        type: 'string',
-        describe: 'Path to xcstrings file',
-        default: defaultPath
-    })
-    .middleware(async (argv) => {
-        if (argv.path !== defaultPath) {
-            return;
-        }
-
-        const config = await loadConfig(argv.config as string | undefined);
-
-        if (!config || !config.xcstringsPaths || config.xcstringsPaths.length === 0) {
-            return;
-        }
-
-        if (config.xcstringsPaths.length === 1) {
-            const entry = config.xcstringsPaths[0];
-            argv.path = typeof entry === 'string' ? entry : entry.path;
-        } else {
-            const choices = config.xcstringsPaths.map((entry) => {
-                if (typeof entry === 'string') {
-                    return { name: entry, value: entry };
-                } else {
-                    return { name: `${entry.alias} (${entry.path})`, value: entry.path };
-                }
-            });
-
-            const selectedPath = await select({
-                message: 'Select xcstrings file:',
-                choices: choices,
-            });
-            argv.path = selectedPath;
-        }
-    })
-    .command(
-        'add',
-        'Add a string',
-        (yargs) => yargs
-            .option('key', {
-                type: 'string',
-                describe: 'The key of the string',
-                demandOption: true,
-            })
-            .option('comment', {
-                type: 'string',
-                describe: 'The comment for the string',
-            })
-            .option('strings', {
-                type: 'string',
-                describe: 'The strings JSON'
-            }),
-        async (argv) => {
-            await runAddCommand(argv.path as string, argv.key as string, argv.comment as string | undefined, argv.strings as unknown);
-            logger.info(chalk.green(`✓ Added key "${argv.key}"`));
-        },
-    )
-    .command(
-        'remove',
-        'Remove a string',
-        (yargs) => yargs.option('key', {
-            type: 'string',
-            describe: 'The key to remove',
-            demandOption: true,
-        }),
-        async (argv) => {
-            await remove(argv.path as string, argv.key as string);
-            logger.info(chalk.green(`✓ Removed key "${argv.key}"`));
-        },
-    )
-    .command(
-        'init',
-        'Initialize configuration file',
-        (yargs) => yargs,
-        async () => {
-            await init();
-        },
-    )
-    .command(
-        'languages',
-        'List supported languages from xcodeproj or xcstrings',
-        (yargs) => yargs,
-        async (argv) => {
-            const result = await languages(argv.path as string, argv.config as string | undefined);
-            logger.info(result.join(' '));
-        },
-    )
-    .demandCommand(1, '')
-    .strictCommands()
-    .recommendCommands()
-    .showHelpOnFail(true)
-    .fail((msg, err, yargsInstance) => {
-        if (err) {
-            console.error(err);
-            throw err;
-        }
-        if (msg) {
-            console.error(chalk.red(msg));
-            console.log();
-        }
-        yargsInstance.showHelp();
-        process.exit(1);
-    })
-    .help()
-    .argv;

package/src/utils/cli.ts

@@ -1,60 +0,0 @@
-import { add } from '../commands/index.js';
-
-export async function readStdinToString(): Promise<string> {
-    return new Promise((resolve) => {
-        let data = '';
-        process.stdin.setEncoding('utf8');
-        process.stdin.on('data', (chunk) => {
-            data += chunk;
-        });
-        process.stdin.on('end', () => {
-            resolve(data);
-        });
-        if (process.stdin.readableEnded) {
-            resolve('');
-        }
-    });
-}
-
-export async function parseStringsArg(
-    stringsArg: unknown,
-    stdinReader: () => Promise<string> = readStdinToString,
-): Promise<Record<string, string> | undefined> {
-    if (stringsArg === undefined) {
-        return undefined;
-    }
-    if (stringsArg === '') {
-        const stdin = await stdinReader();
-        if (!stdin.trim()) return undefined;
-        return JSON.parse(stdin);
-    }
-    if (typeof stringsArg === 'string') {
-        return JSON.parse(stringsArg);
-    }
-    if (Array.isArray(stringsArg)) {
-        const merged: Record<string, string> = {};
-        for (const item of stringsArg) {
-            if (typeof item === 'string') {
-                Object.assign(merged, JSON.parse(item));
-            }
-        }
-        return merged;
-    }
-    if (typeof stringsArg === 'boolean' && stringsArg === true) {
-        const stdin = await stdinReader();
-        if (!stdin.trim()) return undefined;
-        return JSON.parse(stdin);
-    }
-    return undefined;
-}
-
-export async function runAddCommand(
-    path: string,
-    key: string,
-    comment: string | undefined,
-    stringsArg: unknown,
-    stdinReader: () => Promise<string> = readStdinToString,
-): Promise<void> {
-    const strings = await parseStringsArg(stringsArg, stdinReader);
-    await add(path, key, comment, strings);
-}

package/src/utils/config.ts

@@ -1,32 +0,0 @@
-import { cosmiconfig } from 'cosmiconfig';
-import json5 from 'json5';
-
-const moduleName = 'xcstrings-cli';
-
-const explorer = cosmiconfig(moduleName, {
-    searchPlaces: [
-        `${moduleName}.json`,
-        `${moduleName}.json5`,
-    ],
-    loaders: {
-        '.json5': async (filepath: string, content: string) => {
-            return json5.parse(content);
-        },
-    },
-    cache: false,
-});
-
-export interface Config {
-    xcstringsPaths?: (string | { alias: string; path: string })[];
-    xcodeprojPaths?: string[];
-}
-
-export async function loadConfig(explicitPath?: string): Promise<Config | null> {
-    if (explicitPath) {
-        const result = await explorer.load(explicitPath);
-        return result ? (result.config as Config) : null;
-    }
-
-    const result = await explorer.search();
-    return result ? (result.config as Config) : null;
-}

package/src/utils/logger.ts

@@ -1,7 +0,0 @@
-import pino from 'pino';
-
-const logger = pino({
-    level: process.env.LOG_LEVEL || 'info',
-});
-
-export default logger;

package/tests/cli.heredoc.test.ts

@@ -1,44 +0,0 @@
-import { describe, it, expect, afterEach } from 'vitest';
-import { resolve } from 'node:path';
-import { readFile } from 'node:fs/promises';
-import { setupTempFile, cleanupTempFiles } from './utils/testFileHelper';
-import { spawn } from 'child_process';
-
-afterEach(async () => await cleanupTempFiles());
-
-describe('cli: heredoc stdin', () => {
-    it('should accept JSON from stdin when --strings flag passed without value (heredoc)', async () => {
-        const stdin = JSON.stringify({ en: 'Hello', ja: 'こんにちは', 'zh-Hans': '你好，世界.' });
-
-        const tempFile = await setupTempFile('no-strings.xcstrings');
-
-        const node = process.execPath;
-        const cliPath = resolve(process.cwd(), 'dist', 'index.js');
-        const args = ['--enable-source-maps', cliPath, 'add', '--key', 'greeting', '--comment', 'Hello, World', '--strings', '--path', tempFile];
-
-        const child = spawn(node, args, { stdio: ['pipe', 'pipe', 'pipe'] });
-
-        child.stdin.write(stdin);
-        child.stdin.end();
-
-        await new Promise<void>((resolvePromise, reject) => {
-            let stdout = '';
-            let stderr = '';
-            child.stdout.on('data', (chunk) => stdout += chunk);
-            child.stderr.on('data', (chunk) => stderr += chunk);
-            child.on('exit', (code) => {
-                if (code !== 0) {
-                    reject(new Error(`Process exited with non-zero code ${code}. Stderr: ${stderr}`));
-                } else {
-                    resolvePromise();
-                }
-            });
-        });
-
-        const content = JSON.parse(await readFile(tempFile, 'utf-8'));
-        expect(content.strings).toHaveProperty('greeting');
-        expect(content.strings.greeting.localizations.en.stringUnit.value).toBe('Hello');
-        expect(content.strings.greeting.localizations.ja.stringUnit.value).toBe('こんにちは');
-        expect(content.strings.greeting.localizations['zh-Hans'].stringUnit.value).toBe('你好，世界.');
-    });
-});

package/tests/cli.stdin.test.ts

@@ -1,61 +0,0 @@
-import { describe, it, expect, afterEach } from 'vitest';
-import { parseStringsArg, runAddCommand } from '../src/utils/cli';
-import { readFile } from 'node:fs/promises';
-import { setupTempFile, cleanupTempFiles } from './utils/testFileHelper';
-
-afterEach(async () => await cleanupTempFiles());
-
-describe('cli: stdin strings', () => {
-    it('parseStringsArg: should read JSON from stdin when strings option provided without value', async () => {
-        const stdin = `{
-            "en": "Hello",
-            "ja": "こんにちは",
-            "zh-Hans": "你好，世界."
-        }`;
-
-        const result = await parseStringsArg(true, async () => Promise.resolve(stdin));
-        expect(result).toBeDefined();
-        expect(result?.en).toBe('Hello');
-        expect(result?.ja).toBe('こんにちは');
-        expect(result?.['zh-Hans']).toBe('你好，世界.');
-    });
-
-    it('parseStringsArg: should read JSON from stdin when strings option provided as empty string ("")', async () => {
-        const stdin = `{"en":"Hello","ja":"こんにちは","zh-Hans":"你好，世界."}`;
-
-        const result = await parseStringsArg('', async () => Promise.resolve(stdin));
-        expect(result).toBeDefined();
-        expect(result?.en).toBe('Hello');
-        expect(result?.ja).toBe('こんにちは');
-        expect(result?.['zh-Hans']).toBe('你好，世界.');
-    });
-
-    it('add: should add strings read from stdin', async () => {
-        const stdin = `{"en":"Hello","ja":"こんにちは","zh-Hans":"你好，世界."}`;
-
-        const tempFile = await setupTempFile('no-strings.xcstrings');
-        await runAddCommand(tempFile, 'greeting', 'Hello, World', true, async () => Promise.resolve(stdin));
-
-        const content = JSON.parse(await readFile(tempFile, 'utf-8'));
-        expect(content.strings).toHaveProperty('greeting');
-        expect(content.strings.greeting.localizations.en.stringUnit.value).toBe('Hello');
-        expect(content.strings.greeting.localizations.ja.stringUnit.value).toBe('こんにちは');
-        expect(content.strings.greeting.localizations['zh-Hans'].stringUnit.value).toBe('你好，世界.');
-    });
-
-    it('parseStringsArg: should parse strings when provided as an inline JSON string', async () => {
-        const str = `{ "en": "Hello", "ja": "こんにちは" }`;
-        const result = await parseStringsArg(str, async () => Promise.resolve(''));
-        expect(result).toBeDefined();
-        expect(result?.en).toBe('Hello');
-        expect(result?.ja).toBe('こんにちは');
-    });
-
-    it('parseStringsArg: should merge arrays passed for --strings multiple times', async () => {
-        const items = ['{"en":"Hello"}', '{"ja":"こんにちは"}'];
-        const result = await parseStringsArg(items as unknown as string[], async () => Promise.resolve(''));
-        expect(result).toBeDefined();
-        expect(result?.en).toBe('Hello');
-        expect(result?.ja).toBe('こんにちは');
-    });
-});

package/tests/cli.unknown.test.ts

@@ -1,24 +0,0 @@
-import { describe, it, expect } from 'vitest';
-import { resolve } from 'node:path';
-import { spawn } from 'child_process';
-
-describe('cli: unknown command', () => {
-    it('should exit non-zero and print help when unknown subcommand is passed', async () => {
-        const node = process.execPath;
-        const cliPath = resolve(process.cwd(), 'dist', 'index.js');
-        const args = ['--enable-source-maps', cliPath, 'hello'];
-
-        const child = spawn(node, args, { stdio: ['pipe', 'pipe', 'pipe'] });
-
-        await new Promise<void>((resolvePromise) => {
-            let stderr = '';
-            child.stderr.on('data', (chunk) => stderr += chunk);
-            child.on('exit', (code) => {
-                expect(code).not.toBe(0);
-                expect(stderr).toMatch(/Unknown/i);
-                expect(stderr).toMatch(/xcstrings/);
-                resolvePromise();
-            });
-        });
-    });
-});

package/tests/commands.test.ts

@@ -1,38 +0,0 @@
-import { describe, it, expect, afterEach } from 'vitest';
-import { add, remove } from '../src/commands/index';
-import { readFile } from 'node:fs/promises';
-import { setupTempFile, cleanupTempFiles } from './utils/testFileHelper';
-
-afterEach(async () => await cleanupTempFiles());
-
-describe('commands', () => {
-    it('add: should add a string to no-strings.xcstrings', async () => {
-        const tempFile = await setupTempFile('no-strings.xcstrings');
-
-        await add(tempFile, 'greeting', 'Hello World', {
-            en: 'Hello',
-            ja: 'こんにちは'
-        });
-
-        const contentString = await readFile(tempFile, 'utf-8');
-        const content = JSON.parse(contentString);
-        expect(content.strings).toHaveProperty('greeting');
-        expect(content.strings.greeting.comment).toBe('Hello World');
-        expect(content.strings.greeting.localizations.en.stringUnit.value).toBe('Hello');
-        expect(content.strings.greeting.localizations.ja.stringUnit.value).toBe('こんにちは');
-        expect(content.strings.greeting.extractionState).toBe('manual');
-    });
-
-    it('remove: should remove a string from manual-comment-3langs.xcstrings', async () => {
-        const tempFile = await setupTempFile('manual-comment-3langs.xcstrings');
-
-        let content = JSON.parse(await readFile(tempFile, 'utf-8'));
-        expect(content.strings).toHaveProperty('closeAction');
-
-        await remove(tempFile, 'closeAction');
-
-        content = JSON.parse(await readFile(tempFile, 'utf-8'));
-        expect(content.strings).not.toHaveProperty('closeAction');
-        expect(content).toHaveProperty('sourceLanguage', 'en');
-    });
-});

package/tests/config.test.ts

@@ -1,54 +0,0 @@
-import { describe, it, expect, vi, beforeEach, afterEach } from 'vitest';
-import { loadConfig } from '../src/utils/config';
-import { resolve } from 'path';
-import fs from 'fs/promises';
-
-describe('loadConfig', () => {
-    const cwd = process.cwd();
-    const configJsonPath = resolve(cwd, 'xcstrings-cli.json');
-    const configJson5Path = resolve(cwd, 'xcstrings-cli.json5');
-
-    beforeEach(async () => {
-        try { await fs.unlink(configJsonPath); } catch { }
-        try { await fs.unlink(configJson5Path); } catch { }
-    });
-
-    afterEach(async () => {
-        try { await fs.unlink(configJsonPath); } catch { }
-        try { await fs.unlink(configJson5Path); } catch { }
-    });
-
-    it('should load config from xcstrings-cli.json', async () => {
-        const config = { xcstringsPaths: ['path/to/Localizable.xcstrings'] };
-        await fs.writeFile(configJsonPath, JSON.stringify(config));
-
-        const result = await loadConfig();
-        expect(result).toEqual(config);
-    });
-
-    it('should load config from xcstrings-cli.json5', async () => {
-        const configContent = "{ xcstringsPaths: ['path/to/Localizable.xcstrings'] }";
-        await fs.writeFile(configJson5Path, configContent);
-
-        const result = await loadConfig();
-        expect(result).toEqual({ xcstringsPaths: ['path/to/Localizable.xcstrings'] });
-    });
-
-    it('should prefer explicit path', async () => {
-        const explicitPath = resolve(cwd, 'custom-config.json');
-        const config = { xcstringsPaths: ['custom/path'] };
-        await fs.writeFile(explicitPath, JSON.stringify(config));
-
-        try {
-            const result = await loadConfig(explicitPath);
-            expect(result).toEqual(config);
-        } finally {
-            await fs.unlink(explicitPath);
-        }
-    });
-
-    it('should return null if no config found', async () => {
-        const result = await loadConfig();
-        expect(result).toBeNull();
-    });
-});

package/tests/fixtures/manual-comment-3langs.xcstrings

@@ -1,32 +0,0 @@
-{
-  "sourceLanguage" : "en",
-  "strings" : {
-    "nonTranslatableString" : {
-      "shouldTranslate" : false
-    },
-    "closeAction" : {
-      "comment" : "Button title of closing a dialog, etc.",
-      "extractionState" : "manual",
-      "localizations" : {
-        "en" : {
-          "stringUnit" : {
-            "state" : "translated",
-            "value" : "Close"
-          }
-        },
-        "ja" : {
-          "stringUnit" : {
-            "state" : "translated",
-            "value" : "閉じる"
-          }
-        },
-        "zh-Hans" : {
-          "stringUnit" : {
-            "state" : "translated",
-            "value" : "关闭"
-          }
-        }
-      }
-    }
-  }
-}

package/tests/fixtures/no-strings.xcstrings

@@ -1,5 +0,0 @@
-{
-  "sourceLanguage" : "en",
-  "strings" : {
-  }
-}

package/tests/fixtures/test.xcodeproj/project.pbxproj

@@ -1,86 +0,0 @@
-// !$*UTF8*$!
-{
-	archiveVersion = 1;
-	classes = {
-	};
-	objectVersion = 56;
-	objects = {
-
-/* Begin PBXGroup section */
-		13B07FAE1A68108700A75B9A = {
-			isa = PBXGroup;
-			children = (
-			);
-			name = TestApp;
-			sourceTree = "<group>";
-		};
-		83CBB9F61A601CBA00E9B192 = {
-			isa = PBXGroup;
-			children = (
-				13B07FAE1A68108700A75B9A /* TestApp */,
-			);
-			indentWidth = 2;
-			sourceTree = "<group>";
-			tabWidth = 2;
-			usesTabs = 0;
-		};
-/* End PBXGroup section */
-
-/* Begin PBXProject section */
-		83CBB9F71A601CBA00E9B192 /* Project object */ = {
-			isa = PBXProject;
-			attributes = {
-				LastSwiftUpdateCheck = 1340;
-				LastUpgradeCheck = 1130;
-				TargetAttributes = {
-				};
-			};
-			buildConfigurationList = 83CBB9FA1A601CBA00E9B192 /* Build configuration list for PBXProject "TestApp" */;
-			compatibilityVersion = "Xcode 12.0";
-			developmentRegion = en;
-			hasScannedForEncodings = 0;
-			knownRegions = (
-				en,
-				Base,
-				ja,
-				de,
-			);
-			mainGroup = 83CBB9F61A601CBA00E9B192;
-			projectDirPath = "";
-			projectRoot = "";
-			targets = (
-			);
-		};
-/* End PBXProject section */
-
-/* Begin XCBuildConfiguration section */
-		83CBBA201A601CBA00E9B192 /* Debug */ = {
-			isa = XCBuildConfiguration;
-			buildSettings = {
-				ALWAYS_SEARCH_USER_PATHS = NO;
-			};
-			name = Debug;
-		};
-		83CBBA211A601CBA00E9B192 /* Release */ = {
-			isa = XCBuildConfiguration;
-			buildSettings = {
-				ALWAYS_SEARCH_USER_PATHS = NO;
-			};
-			name = Release;
-		};
-/* End XCBuildConfiguration section */
-
-/* Begin XCConfigurationList section */
-		83CBB9FA1A601CBA00E9B192 /* Build configuration list for PBXProject "TestApp" */ = {
-			isa = XCConfigurationList;
-			buildConfigurations = (
-				83CBBA201A601CBA00E9B192 /* Debug */,
-				83CBBA211A601CBA00E9B192 /* Release */,
-			);
-			defaultConfigurationIsVisible = 0;
-			defaultConfigurationName = Release;
-		};
-/* End XCConfigurationList section */
-	};
-	rootObject = 83CBB9F71A601CBA00E9B192 /* Project object */;
-}

package/tests/formatting.test.ts

@@ -1,72 +0,0 @@
-
-import { describe, it, expect } from 'vitest';
-import { formatXCStrings } from '../src/commands/index';
-
-describe('formatXCStrings', () => {
-    it('should add space before colon in simple objects', () => {
-        const input = JSON.stringify({ key: "value" }, null, 2);
-        const expected = input.replace('":', '" :');
-        expect(formatXCStrings(input)).toBe(expected);
-        expect(formatXCStrings(input)).toContain('"key" : "value"');
-    });
-
-    it('should handle nested objects', () => {
-        const obj = {
-            nested: {
-                child: "grandchild"
-            }
-        };
-        const input = JSON.stringify(obj, null, 2);
-        const output = formatXCStrings(input);
-        expect(output).toContain('"nested" : {');
-        expect(output).toContain('"child" : "grandchild"');
-    });
-
-    it('should not affect colons inside string values', () => {
-        const obj = {
-            "key:with:colons": "value:with:colons"
-        };
-        const input = JSON.stringify(obj, null, 2);
-        const output = formatXCStrings(input);
-        expect(output).toContain('"key:with:colons" : "value:with:colons"');
-    });
-
-    it('should handle escaped quotes inside strings', () => {
-        const obj = {
-            tricky: 'value has ": sequence inside'
-        };
-        const input = JSON.stringify(obj, null, 2);
-        const output = formatXCStrings(input);
-        expect(output).toContain('"tricky" : "value has \\": sequence inside"');
-    });
-
-    it('should handle backslashes correctly', () => {
-        const obj = {
-            path: 'C:\\Windows\\System32'
-        };
-        const input = JSON.stringify(obj, null, 2);
-        const output = formatXCStrings(input);
-        expect(output).toContain('"path" : "C:\\\\Windows\\\\System32"');
-    });
-
-    it('should maintain data integrity when parsed back', () => {
-        const obj = {
-            "normalKey": "normalValue",
-            "key with spaces": "value with spaces",
-            "key:with:colons": "value:with:colons",
-            "key\"with\"quotes": "value\"with\"quotes",
-            "key\\with\\backslashes": "value\\with\\backslashes",
-            "nested": {
-                "child": "grandchild"
-            },
-            "empty": {},
-            "tricky": "value has \": sequence inside",
-            "tricky2": "value ending in quote\"",
-            "tricky3": "value ending in backslash\\"
-        };
-        const input = JSON.stringify(obj, null, 2);
-        const output = formatXCStrings(input);
-        const parsed = JSON.parse(output);
-        expect(parsed).toEqual(obj);
-    });
-});

package/tests/languages.test.ts

@@ -1,21 +0,0 @@
-import { describe, it, expect } from 'vitest';
-import { getLanguagesFromXcodeproj, getLanguagesFromXCStrings } from '../src/commands/languages';
-import { resolve } from 'node:path';
-import { FIXTURES_DIR } from './utils/resources';
-
-describe('languages', () => {
-    it('should extract knownRegions from xcodeproj', () => {
-        const xcodeprojPath = resolve(FIXTURES_DIR, 'test.xcodeproj');
-        const languages = getLanguagesFromXcodeproj(xcodeprojPath);
-
-        expect(languages).toEqual(['en', 'Base', 'ja', 'de']);
-    });
-
-    it('should extract languages from xcstrings file', async () => {
-        const xcstringsPath = resolve(FIXTURES_DIR, 'manual-comment-3langs.xcstrings');
-        const languages = await getLanguagesFromXCStrings(xcstringsPath);
-        expect(languages).toContain('ja');
-        expect(languages).toContain('en');
-        expect(languages).toContain('zh-Hans');
-    });
-});

package/tests/utils/resources.ts

@@ -1,4 +0,0 @@
-import { resolve } from "path";
-
-export const FIXTURES_DIR = resolve(__dirname, '..', 'fixtures');
-export const TEMP_DIR = resolve(__dirname, '..', 'temp');

package/tests/utils/testFileHelper.ts

@@ -1,30 +0,0 @@
-import { resolve, basename, extname } from 'node:path';
-import { copyFile, mkdir, unlink } from 'node:fs/promises';
-import { existsSync } from 'node:fs';
-import { FIXTURES_DIR, TEMP_DIR } from './resources';
-
-export const createdFiles: string[] = [];
-
-export async function setupTempFile(fileName: string): Promise<string> {
-    if (!existsSync(TEMP_DIR)) {
-        await mkdir(TEMP_DIR);
-    }
-    const source = resolve(FIXTURES_DIR, fileName);
-    const base = basename(fileName, extname(fileName));
-    const unique = `${base}-${Date.now()}-${Math.random().toString(36).slice(2)}${extname(fileName)}`;
-    const dest = resolve(TEMP_DIR, unique);
-    await copyFile(source, dest);
-    createdFiles.push(dest);
-    return dest;
-}
-
-export async function cleanupTempFiles(): Promise<void> {
-    for (const f of createdFiles) {
-        try {
-            await unlink(f);
-        } catch {
-            // ignore: best effort cleanup
-        }
-    }
-    createdFiles.length = 0;
-}

package/tsconfig.json

@@ -1,19 +0,0 @@
-{
-    "compilerOptions": {
-        "target": "ESNext",
-        "module": "ESNext",
-        "moduleResolution": "bundler",
-        "strict": true,
-        "esModuleInterop": true,
-        "skipLibCheck": true,
-        "forceConsistentCasingInFileNames": true,
-        "outDir": "./dist",
-        "declaration": true
-    },
-    "include": [
-        "src/**/*"
-    ],
-    "exclude": [
-        "node_modules"
-    ]
-}

package/vite.config.ts

@@ -1,32 +0,0 @@
-import { defineConfig } from 'vite';
-import { resolve } from 'path';
-
-export default defineConfig({
-    build: {
-        lib: {
-            entry: resolve(__dirname, 'src/index.ts'),
-            fileName: 'index',
-            formats: ['es'],
-        },
-        rollupOptions: {
-            external: [
-                /^node:.*/,
-                'fs',
-                'path',
-                'os',
-                'crypto',
-                'assert',
-                'util',
-                'yargs',
-                'yargs/helpers',
-                'cosmiconfig',
-                'json5',
-                '@inquirer/prompts',
-                '@bacons/xcode',
-                'chalk',
-            ],
-        },
-        target: 'node18',
-        emptyOutDir: true,
-    },
-});