ai-l10n-sdk 1.1.3 → 1.2.0

package/README.md

@@ -94,6 +94,38 @@ const result = await translator.translate({
 - **Automatic Metadata Updates**: The API automatically updates `@@locale` to the target language code and `@@last_modified` to the current UTC timestamp
 - **Custom Prefixes**: Supports custom file naming patterns (e.g., `app_en_US.arb`, `my_app_fr.arb`)
 
+### JSONC Files
+
+Full support for JSONC (JSON with Comments) files:
+
+```typescript
+const result = await translator.translate({
+  sourceFile: './locales/en.jsonc',
+  targetLanguages: ['es', 'fr', 'de']
+});
+```
+
+**JSONC Features:**
+- Works exactly like JSON files but with `.jsonc` extension
+- Auto-detects `.jsonc` files in project structure alongside `.json` files
+
+### Shopify Theme Localization
+
+Full support for Shopify theme localization file patterns:
+
+```typescript
+const result = await translator.translate({
+  sourceFile: './locales/en.default.schema.json',
+  targetLanguages: ['es-ES', 'fr', 'de']
+});
+// Creates: es-ES.schema.json, fr.schema.json, de.schema.json
+```
+
+**Shopify Theme Features:**
+- **Automatic Pattern Recognition**: Detects files with `.default.` in the name (e.g., `en.default.schema.json`)
+- **Smart Output Naming**: Removes `.default.` from target files while preserving the `.schema.` suffix
+- **Language Detection**: Auto-detects target languages from existing files (e.g., `es-ES.schema.json`, `fr.schema.json`)
+
 ### Multiple Files
 
 ```typescript

package/dist/i18nProjectManager.d.ts

@@ -14,6 +14,7 @@ export declare class I18nProjectManager {
      * Extracts language code from file name, handling custom prefixes for ARB files
      * ARB files: app_en_US.arb -> en_US, my_app_fr.arb -> fr
      * JSON files: en-US.json -> en-US
+     * Shopify theme: en.default.schema.json -> en, es-ES.schema.json -> es-ES
      */
     private extractLanguageCodeFromFileName;
 }

package/dist/i18nProjectManager.js

@@ -80,17 +80,22 @@ class I18nProjectManager {
         }
         else if (structureInfo.type === ProjectStructureType.FileBased) {
             // For file-based, scan the base path for language files
-            const fileExtension = isArbFile ? ".arb" : ".json";
+            const fileExtensions = isArbFile ? [".arb"] : [".json", ".jsonc"];
             try {
                 const entries = fs.readdirSync(structureInfo.basePath, {
                     withFileTypes: true,
                 });
                 for (const entry of entries) {
-                    if (entry.isFile() && entry.name.endsWith(fileExtension)) {
-                        const fileName = path.basename(entry.name, fileExtension);
-                        const languageCode = this.extractLanguageCodeFromFileName(fileName, isArbFile);
-                        if (languageCode) {
-                            languageCodes.add(languageCode);
+                    if (entry.isFile()) {
+                        for (const ext of fileExtensions) {
+                            if (entry.name.endsWith(ext)) {
+                                const fileName = path.basename(entry.name, ext);
+                                const languageCode = this.extractLanguageCodeFromFileName(fileName, isArbFile);
+                                if (languageCode) {
+                                    languageCodes.add(languageCode);
+                                }
+                                break;
+                            }
                         }
                     }
                 }
@@ -141,8 +146,12 @@ class I18nProjectManager {
                     return targetFilePath;
                 }
                 else {
+                    // Handle Shopify theme pattern: en.default.schema.json -> es-ES.schema.json
+                    // Extract suffix (e.g., ".schema") if present
+                    const schemaMatch = sourceFileName.match(/\.(schema)$/);
+                    const suffix = schemaMatch ? `.${schemaMatch[1]}` : "";
                     // Save in the same directory with target language as filename
-                    const targetFilePath = path.join(structureInfo.basePath, `${languageCode}${fileExtension}`);
+                    const targetFilePath = path.join(structureInfo.basePath, `${languageCode}${suffix}${fileExtension}`);
                     return targetFilePath;
                 }
             }
@@ -226,6 +235,7 @@ class I18nProjectManager {
      * Extracts language code from file name, handling custom prefixes for ARB files
      * ARB files: app_en_US.arb -> en_US, my_app_fr.arb -> fr
      * JSON files: en-US.json -> en-US
+     * Shopify theme: en.default.schema.json -> en, es-ES.schema.json -> es-ES
      */
     extractLanguageCodeFromFileName(fileName, isArbFile) {
         if (isArbFile) {
@@ -242,8 +252,15 @@ class I18nProjectManager {
             return null;
         }
         else {
+            // Handle Shopify theme pattern: en.default.schema, es-ES.schema
+            // Remove .schema first, then .default before extracting language code
+            let cleanedFileName = fileName
+                .replace(/\.schema$/, "")
+                .replace(/\.default$/, "");
             // For JSON files, the entire filename should be the language code
-            return this.languageCodeRegex.test(fileName) ? fileName : null;
+            return this.languageCodeRegex.test(cleanedFileName)
+                ? cleanedFileName
+                : null;
         }
     }
 }

package/dist/index.d.ts

@@ -4,7 +4,7 @@ import { ILogger } from "./logger";
  */
 export interface TranslationConfig {
     /**
-     * Path to the source file to translate (JSON or ARB)
+     * Path to the source file to translate (JSON, JSONC, or ARB)
      */
     sourceFile: string;
     /**

package/dist/index.js

@@ -70,9 +70,9 @@ class AiTranslator {
             }
             const fileExtension = path.extname(sourceFilePath);
             const isArbFile = fileExtension === ".arb";
-            const isJsonFile = fileExtension === ".json";
+            const isJsonFile = fileExtension === ".json" || fileExtension === ".jsonc";
             if (!isArbFile && !isJsonFile) {
-                throw new Error(`Unsupported file type: ${fileExtension}. Only .json and .arb files are supported.`);
+                throw new Error(`Unsupported file type: ${fileExtension}. Only .json, .jsonc, and .arb files are supported.`);
             }
             if (verbose) {
                 console.log(`📂 Source file: ${sourceFilePath}`);
@@ -140,6 +140,7 @@ class AiTranslator {
             for (const result of results) {
                 totalCharsUsed += result.charsUsed || 0;
                 if (result.remainingBalance !== undefined &&
+                    result.remainingBalance !== null &&
                     result.remainingBalance < (remainingBalance ?? Infinity)) {
                     remainingBalance = result.remainingBalance;
                 }
@@ -151,7 +152,7 @@ class AiTranslator {
             console.log(`${"=".repeat(50)}`);
             console.log(`✅ Successful: ${successCount}/${targetLanguages.length}`);
             console.log(`📝 Total characters used: ${totalCharsUsed.toLocaleString()}`);
-            if (remainingBalance !== undefined) {
+            if (remainingBalance !== undefined && remainingBalance !== null) {
                 console.log(`💰 Remaining balance: ${remainingBalance.toLocaleString()} characters`);
             }
             if (successCount < targetLanguages.length) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ai-l10n-sdk",
-  "version": "1.1.3",
+  "version": "1.2.0",
   "description": "Lightweight SDK for AI-powered localization automation - programmatic API (no CLI)",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",