i18nsmith 0.1.0

package/src/fixtures/README.md

@@ -0,0 +1,61 @@
+# E2E Test Fixtures
+
+This directory contains fixture projects for end-to-end testing of i18nsmith CLI commands.
+
+## Fixture Projects
+
+### `basic-react`
+A minimal React project with react-i18next for basic workflow testing.
+- Tests: scan, sync, transform, check commands
+- Uses: react-i18next adapter
+
+### `nested-locales`
+Tests nested locale file structure (flat vs nested JSON).
+- Tests: --rewrite-shape flat/nested
+- Uses: Nested JSON structure with dot-delimited keys
+
+### `multi-namespace`
+Tests namespace-based organization.
+- Tests: Namespace scanning, multi-file locales
+- Uses: Multiple namespace JSON files
+
+### `suspicious-keys`
+Tests detection and handling of suspicious key patterns.
+- Tests: audit, sync --strict, auto-rename features
+- Uses: Various problematic key patterns
+
+### `backup-restore`
+Tests backup and restore functionality.
+- Tests: backup-list, backup-restore, --no-backup
+- Uses: Pre-created backup directories
+
+## Usage in Tests
+
+```typescript
+import { setupFixture, cleanupFixture } from './helpers';
+
+describe('some feature', () => {
+  let fixtureDir: string;
+  
+  beforeEach(async () => {
+    fixtureDir = await setupFixture('basic-react');
+  });
+  
+  afterEach(async () => {
+    await cleanupFixture(fixtureDir);
+  });
+  
+  it('should work', () => {
+    const result = runCli(['scan'], { cwd: fixtureDir });
+    expect(result.exitCode).toBe(0);
+  });
+});
+```
+
+## Adding New Fixtures
+
+1. Create a new directory under `fixtures/`
+2. Add `i18n.config.json` with appropriate settings
+3. Add source files and locales as needed
+4. Document the fixture in this README
+5. Add tests that use the fixture

package/src/fixtures/basic-react/i18n.config.json

@@ -0,0 +1,15 @@
+{
+  "sourceLanguage": "en",
+  "targetLanguages": ["fr", "de"],
+  "localesDir": "locales",
+  "include": ["src/**/*.tsx", "src/**/*.ts"],
+  "exclude": ["**/*.test.tsx", "**/*.test.ts"],
+  "translationAdapter": {
+    "module": "react-i18next",
+    "hookName": "useTranslation",
+    "translationIdentifier": "t"
+  },
+  "sync": {
+    "suspiciousKeyPolicy": "warn"
+  }
+}

package/src/fixtures/basic-react/locales/de.json

@@ -0,0 +1,8 @@
+{
+  "common.welcome": "Willkommen in unserer App",
+  "common.goodbye": "Auf Wiedersehen",
+  "buttons.submit": "Absenden",
+  "buttons.cancel": "Abbrechen",
+  "messages.success": "Operation erfolgreich",
+  "messages.error": "Ein Fehler ist aufgetreten"
+}

package/src/fixtures/basic-react/locales/en.json

@@ -0,0 +1,8 @@
+{
+  "common.welcome": "Welcome to our app",
+  "common.goodbye": "Goodbye",
+  "buttons.submit": "Submit",
+  "buttons.cancel": "Cancel",
+  "messages.success": "Operation successful",
+  "messages.error": "An error occurred"
+}

package/src/fixtures/basic-react/locales/fr.json

@@ -0,0 +1,8 @@
+{
+  "common.welcome": "Bienvenue dans notre application",
+  "common.goodbye": "Au revoir",
+  "buttons.submit": "Soumettre",
+  "buttons.cancel": "Annuler",
+  "messages.success": "Opération réussie",
+  "messages.error": "Une erreur est survenue"
+}

package/src/fixtures/basic-react/src/App.tsx

@@ -0,0 +1,15 @@
+import React from 'react';
+import { useTranslation } from 'react-i18next';
+
+export function App() {
+  const { t } = useTranslation();
+  
+  return (
+    <div>
+      <h1>{t('common.welcome')}</h1>
+      <p>Some untranslated text that should be detected</p>
+      <button>{t('buttons.submit')}</button>
+      <button>{t('buttons.cancel')}</button>
+    </div>
+  );
+}

package/src/fixtures/basic-react/src/Messages.tsx

@@ -0,0 +1,12 @@
+import React from 'react';
+import { useTranslation } from 'react-i18next';
+
+export function SuccessMessage() {
+  const { t } = useTranslation();
+  return <div className="success">{t('messages.success')}</div>;
+}
+
+export function ErrorMessage() {
+  const { t } = useTranslation();
+  return <div className="error">{t('messages.error')}</div>;
+}

package/src/fixtures/nested-locales/i18n.config.json

@@ -0,0 +1,9 @@
+{
+  "sourceLanguage": "en",
+  "targetLanguages": ["fr"],
+  "localesDir": "locales",
+  "include": ["src/**/*.tsx"],
+  "locales": {
+    "delimiter": "."
+  }
+}

package/src/fixtures/nested-locales/locales/en.json

@@ -0,0 +1,23 @@
+{
+  "common": {
+    "buttons": {
+      "submit": "Submit",
+      "cancel": "Cancel",
+      "save": "Save"
+    },
+    "labels": {
+      "name": "Name",
+      "email": "Email"
+    }
+  },
+  "pages": {
+    "home": {
+      "title": "Home",
+      "welcome": "Welcome back!"
+    },
+    "settings": {
+      "title": "Settings",
+      "description": "Configure your preferences"
+    }
+  }
+}

package/src/fixtures/nested-locales/locales/fr.json

@@ -0,0 +1,23 @@
+{
+  "common": {
+    "buttons": {
+      "submit": "Soumettre",
+      "cancel": "Annuler",
+      "save": "Sauvegarder"
+    },
+    "labels": {
+      "name": "Nom",
+      "email": "Courriel"
+    }
+  },
+  "pages": {
+    "home": {
+      "title": "Accueil",
+      "welcome": "Bon retour!"
+    },
+    "settings": {
+      "title": "Paramètres",
+      "description": "Configurez vos préférences"
+    }
+  }
+}

package/src/fixtures/nested-locales/src/HomePage.tsx

@@ -0,0 +1,13 @@
+import { useTranslation } from 'react-i18next';
+
+export function HomePage() {
+  const { t } = useTranslation();
+  
+  return (
+    <div>
+      <h1>{t('pages.home.title')}</h1>
+      <p>{t('pages.home.welcome')}</p>
+      <button>{t('common.buttons.submit')}</button>
+    </div>
+  );
+}

package/src/fixtures/suspicious-keys/i18n.config.json

@@ -0,0 +1,9 @@
+{
+  "sourceLanguage": "en",
+  "targetLanguages": ["fr"],
+  "localesDir": "locales",
+  "include": ["src/**/*.tsx"],
+  "sync": {
+    "suspiciousKeyPolicy": "warn"
+  }
+}

package/src/fixtures/suspicious-keys/locales/en.json

@@ -0,0 +1,11 @@
+{
+  "Hello World": "Hello World",
+  "Welcome to our app!": "Welcome to our app!",
+  "Click Here": "Click Here",
+  "Save": "Save",
+  "The Quick Brown Fox": "The Quick Brown Fox",
+  "When to use this feature:": "When to use this feature:",
+  "proper.namespaced.key": "This is a properly namespaced key",
+  "buttons.submit": "Submit",
+  "common.title": "Application Title"
+}

package/src/fixtures/suspicious-keys/locales/fr.json

@@ -0,0 +1,11 @@
+{
+  "Hello World": "Bonjour le monde",
+  "Welcome to our app!": "Bienvenue dans notre application!",
+  "Click Here": "Cliquez ici",
+  "Save": "Sauvegarder",
+  "The Quick Brown Fox": "Le Renard Brun Rapide",
+  "When to use this feature:": "Quand utiliser cette fonctionnalité:",
+  "proper.namespaced.key": "Ceci est une clé correctement nommée",
+  "buttons.submit": "Soumettre",
+  "common.title": "Titre de l'application"
+}

package/src/fixtures/suspicious-keys/src/BadKeys.tsx

@@ -0,0 +1,19 @@
+import { useTranslation } from 'react-i18next';
+
+export function BadKeys() {
+  const { t } = useTranslation();
+  
+  return (
+    <div>
+      {/* These are bad keys - text as key */}
+      <h1>{t('Hello World')}</h1>
+      <p>{t('Welcome to our app!')}</p>
+      <a href="#">{t('Click Here')}</a>
+      <button>{t('Save')}</button>
+      
+      {/* These are good keys */}
+      <p>{t('proper.namespaced.key')}</p>
+      <button>{t('buttons.submit')}</button>
+    </div>
+  );
+}

package/src/index.ts

@@ -0,0 +1,43 @@
+#!/usr/bin/env node
+import { Command } from 'commander';
+import { registerInit } from './commands/init.js';
+import { registerScaffoldAdapter } from './commands/scaffold-adapter.js';
+import { registerTranslate } from './commands/translate.js';
+import { registerPreflight } from './commands/preflight.js';
+import { registerDebugPatterns } from './commands/debug-patterns.js';
+import { registerDiagnose } from './commands/diagnose.js';
+import { registerAudit } from './commands/audit.js';
+import { registerCheck } from './commands/check.js';
+import { registerScan } from './commands/scan.js';
+import { registerTransform } from './commands/transform.js';
+import { registerSync } from './commands/sync.js';
+import { registerBackup } from './commands/backup.js';
+import { registerRename } from './commands/rename.js';
+import { registerInstallHooks } from './commands/install-hooks.js';
+import { registerConfig } from './commands/config.js';
+
+export const program = new Command();
+
+program
+  .name('i18nsmith')
+  .description('Universal Automated i18n Library')
+  .version('0.1.0');
+
+registerInit(program);
+registerScaffoldAdapter(program);
+registerTranslate(program);
+registerPreflight(program);
+registerDebugPatterns(program);
+registerDiagnose(program);
+registerAudit(program);
+registerCheck(program);
+registerScan(program);
+registerTransform(program);
+registerSync(program);
+registerBackup(program);
+registerRename(program);
+registerInstallHooks(program);
+registerConfig(program);
+
+
+program.parse();