lingo.dev 0.108.0 → 0.109.0

package/build/cli.cjs

@@ -1525,6 +1525,16 @@ function composeLoaders(...loaders) {
         result = await loaders[i].push(locale, result);
       }
       return result;
+    },
+    pullHints: async (originalInput) => {
+      let result = originalInput;
+      for (let i = 0; i < loaders.length; i++) {
+        const subResult = await _optionalChain([loaders, 'access', _79 => _79[i], 'access', _80 => _80.pullHints, 'optionalCall', _81 => _81(result)]);
+        if (subResult) {
+          result = subResult;
+        }
+      }
+      return result;
     }
   };
 }
@@ -1541,7 +1551,7 @@ function createLoader(lDefinition) {
       if (state.initCtx) {
         return state.initCtx;
       }
-      state.initCtx = await _optionalChain([lDefinition, 'access', _79 => _79.init, 'optionalCall', _80 => _80()]);
+      state.initCtx = await _optionalChain([lDefinition, 'access', _82 => _82.init, 'optionalCall', _83 => _83()]);
       return state.initCtx;
     },
     setDefaultLocale(locale) {
@@ -1551,6 +1561,9 @@ function createLoader(lDefinition) {
       state.defaultLocale = locale;
       return this;
     },
+    async pullHints() {
+      return _optionalChain([lDefinition, 'access', _84 => _84.pullHints, 'optionalCall', _85 => _85(state.originalInput)]);
+    },
     async pull(locale, input2) {
       if (!state.defaultLocale) {
         throw new Error("Default locale not set");
@@ -1613,12 +1626,220 @@ function createJsonLoader() {
   });
 }
 
+// src/cli/loaders/json5.ts
+var _json5 = require('json5'); var _json52 = _interopRequireDefault(_json5);
+function createJson5Loader() {
+  return createLoader({
+    pull: async (locale, input2) => {
+      const json5String = input2 || "{}";
+      return _json52.default.parse(json5String);
+    },
+    push: async (locale, data) => {
+      const serializedData = _json52.default.stringify(data, null, 2);
+      return serializedData;
+    }
+  });
+}
+
+// src/cli/loaders/jsonc.ts
+var _jsoncparser = require('jsonc-parser');
+function extractCommentsFromJsonc(jsoncString) {
+  const lines = jsoncString.split("\n");
+  const comments = {};
+  const errors = [];
+  const result = _jsoncparser.parse.call(void 0, jsoncString, errors, {
+    allowTrailingComma: true,
+    disallowComments: false,
+    allowEmptyContent: true
+  });
+  if (errors.length > 0) {
+    return {};
+  }
+  const contextStack = [];
+  for (let i = 0; i < lines.length; i++) {
+    const line = lines[i];
+    const trimmedLine = line.trim();
+    if (!trimmedLine) continue;
+    const commentData = extractCommentFromLine(line, lines, i);
+    if (commentData.hint) {
+      let keyInfo;
+      if (commentData.isInline) {
+        const keyMatch = line.match(/^\s*["']?([^"':,\s]+)["']?\s*:/);
+        if (keyMatch) {
+          const key = keyMatch[1];
+          const path17 = contextStack.map((ctx) => ctx.key).filter(Boolean);
+          keyInfo = { key, path: path17 };
+        }
+      } else {
+        keyInfo = findAssociatedKey(lines, commentData.lineIndex, contextStack);
+      }
+      if (keyInfo && keyInfo.key) {
+        setCommentAtPath(comments, keyInfo.path, keyInfo.key, commentData.hint);
+      }
+      i = commentData.endIndex;
+      continue;
+    }
+    updateContext(contextStack, line, result);
+  }
+  return comments;
+}
+function extractCommentFromLine(line, lines, lineIndex) {
+  const trimmed = line.trim();
+  if (trimmed.startsWith("//")) {
+    const hint = trimmed.replace(/^\/\/\s*/, "").trim();
+    return { hint, lineIndex, endIndex: lineIndex, isInline: false };
+  }
+  if (trimmed.startsWith("/*")) {
+    const blockResult = extractBlockComment(lines, lineIndex);
+    return { ...blockResult, isInline: false };
+  }
+  const singleInlineMatch = line.match(/^(.+?)\s*\/\/\s*(.+)$/);
+  if (singleInlineMatch && singleInlineMatch[1].includes(":")) {
+    const hint = singleInlineMatch[2].trim();
+    return { hint, lineIndex, endIndex: lineIndex, isInline: true };
+  }
+  const blockInlineMatch = line.match(/^(.+?)\s*\/\*\s*(.*?)\s*\*\/.*$/);
+  if (blockInlineMatch && blockInlineMatch[1].includes(":")) {
+    const hint = blockInlineMatch[2].trim();
+    return { hint, lineIndex, endIndex: lineIndex, isInline: true };
+  }
+  return { hint: null, lineIndex, endIndex: lineIndex, isInline: false };
+}
+function extractBlockComment(lines, startIndex) {
+  const startLine = lines[startIndex];
+  const singleMatch = startLine.match(/\/\*\s*(.*?)\s*\*\//);
+  if (singleMatch) {
+    return {
+      hint: singleMatch[1].trim(),
+      lineIndex: startIndex,
+      endIndex: startIndex
+    };
+  }
+  const commentParts = [];
+  let endIndex = startIndex;
+  const firstContent = startLine.replace(/.*?\/\*\s*/, "").trim();
+  if (firstContent && !firstContent.includes("*/")) {
+    commentParts.push(firstContent);
+  }
+  for (let i = startIndex + 1; i < lines.length; i++) {
+    const line = lines[i];
+    endIndex = i;
+    if (line.includes("*/")) {
+      const lastContent = line.replace(/\*\/.*$/, "").replace(/^\s*\*?\s*/, "").trim();
+      if (lastContent) {
+        commentParts.push(lastContent);
+      }
+      break;
+    } else {
+      const content = line.replace(/^\s*\*?\s*/, "").trim();
+      if (content) {
+        commentParts.push(content);
+      }
+    }
+  }
+  return {
+    hint: commentParts.join(" ").trim() || null,
+    lineIndex: startIndex,
+    endIndex
+  };
+}
+function findAssociatedKey(lines, commentLineIndex, contextStack) {
+  for (let i = commentLineIndex + 1; i < lines.length; i++) {
+    const line = lines[i].trim();
+    if (!line || line.startsWith("//") || line.startsWith("/*") || line === "{" || line === "}") {
+      continue;
+    }
+    const keyMatch = line.match(/^\s*["']?([^"':,\s]+)["']?\s*:/);
+    if (keyMatch) {
+      const key = keyMatch[1];
+      const path17 = contextStack.map((ctx) => ctx.key).filter(Boolean);
+      return { key, path: path17 };
+    }
+  }
+  return { key: null, path: [] };
+}
+function updateContext(contextStack, line, parsedJson) {
+  const openBraces = (line.match(/\{/g) || []).length;
+  const closeBraces = (line.match(/\}/g) || []).length;
+  if (openBraces > closeBraces) {
+    const keyMatch = line.match(/^\s*["']?([^"':,\s]+)["']?\s*:\s*\{/);
+    if (keyMatch) {
+      contextStack.push({ key: keyMatch[1], isArray: false });
+    }
+  } else if (closeBraces > openBraces) {
+    for (let i = 0; i < closeBraces - openBraces; i++) {
+      contextStack.pop();
+    }
+  }
+}
+function setCommentAtPath(comments, path17, key, hint) {
+  let current = comments;
+  for (const pathKey of path17) {
+    if (!current[pathKey]) {
+      current[pathKey] = {};
+    }
+    current = current[pathKey];
+  }
+  if (!current[key]) {
+    current[key] = {};
+  }
+  if (typeof current[key] === "object" && current[key] !== null) {
+    current[key].hint = hint;
+  } else {
+    current[key] = { hint };
+  }
+}
+function createJsoncLoader() {
+  return createLoader({
+    pull: async (locale, input2) => {
+      const jsoncString = input2 || "{}";
+      const errors = [];
+      const result = _jsoncparser.parse.call(void 0, jsoncString, errors, {
+        allowTrailingComma: true,
+        disallowComments: false,
+        allowEmptyContent: true
+      });
+      if (errors.length > 0) {
+        throw new Error(`Failed to parse JSONC: ${errors[0].error}`);
+      }
+      return result || {};
+    },
+    push: async (locale, data) => {
+      const serializedData = JSON.stringify(data, null, 2);
+      return serializedData;
+    },
+    pullHints: async (input2) => {
+      if (!input2 || typeof input2 !== "string") {
+        return {};
+      }
+      try {
+        return extractCommentsFromJsonc(input2);
+      } catch (error) {
+        console.warn("Failed to extract comments from JSONC:", error);
+        return {};
+      }
+    }
+  });
+}
+
 // src/cli/loaders/flat.ts
 var _flat = require('flat');
 
 var OBJECT_NUMERIC_KEY_PREFIX = "__lingodotdev__obj__";
 function createFlatLoader() {
-  return composeLoaders(createDenormalizeLoader(), createNormalizeLoader());
+  const composedLoader = composeLoaders(
+    createDenormalizeLoader(),
+    createNormalizeLoader()
+  );
+  return {
+    ...composedLoader,
+    pullHints: async (input2) => {
+      if (!input2 || typeof input2 !== "object") {
+        return {};
+      }
+      return flattenHints(input2);
+    }
+  };
 }
 function createDenormalizeLoader() {
   return createLoader({
@@ -1646,7 +1867,7 @@ function createNormalizeLoader() {
       return normalized;
     },
     push: async (locale, data, originalInput) => {
-      const keysMap = _nullishCoalesce(_optionalChain([originalInput, 'optionalAccess', _81 => _81.keysMap]), () => ( {}));
+      const keysMap = _nullishCoalesce(_optionalChain([originalInput, 'optionalAccess', _86 => _86.keysMap]), () => ( {}));
       const input2 = mapDenormalizedKeys(data, keysMap);
       const denormalized = _flat.unflatten.call(void 0, input2, {
         delimiter: "/",
@@ -1709,6 +1930,33 @@ function normalizeObjectKeys(obj) {
     return obj;
   }
 }
+function flattenHints(obj, parentHints = [], parentPath = "") {
+  const result = {};
+  for (const [key, _value] of Object.entries(obj)) {
+    if (_lodash2.default.isObject(_value) && !_lodash2.default.isArray(_value)) {
+      const value = _value;
+      const currentHints = [...parentHints];
+      const currentPath = parentPath ? `${parentPath}/${key}` : key;
+      if (value.hint && typeof value.hint === "string") {
+        currentHints.push(value.hint);
+      }
+      const nestedObj = _lodash2.default.omit(value, "hint");
+      if (Object.keys(nestedObj).length === 0) {
+        if (currentHints.length > 0) {
+          result[currentPath] = currentHints;
+        }
+      } else {
+        const nestedComments = flattenHints(
+          nestedObj,
+          currentHints,
+          currentPath
+        );
+        Object.assign(result, nestedComments);
+      }
+    }
+  }
+  return result;
+}
 
 // src/cli/loaders/text-file.ts
 var _promises3 = require('fs/promises'); var _promises4 = _interopRequireDefault(_promises3);
@@ -1753,8 +2001,8 @@ async function getTrailingNewLine(pathPattern, locale, originalLocale) {
   if (!templateData) {
     templateData = await readFileForLocale(pathPattern, originalLocale);
   }
-  if (_optionalChain([templateData, 'optionalAccess', _82 => _82.match, 'call', _83 => _83(/[\r\n]$/)])) {
-    const ending = _optionalChain([templateData, 'optionalAccess', _84 => _84.includes, 'call', _85 => _85("\r\n")]) ? "\r\n" : _optionalChain([templateData, 'optionalAccess', _86 => _86.includes, 'call', _87 => _87("\r")]) ? "\r" : "\n";
+  if (_optionalChain([templateData, 'optionalAccess', _87 => _87.match, 'call', _88 => _88(/[\r\n]$/)])) {
+    const ending = _optionalChain([templateData, 'optionalAccess', _89 => _89.includes, 'call', _90 => _90("\r\n")]) ? "\r\n" : _optionalChain([templateData, 'optionalAccess', _91 => _91.includes, 'call', _92 => _92("\r")]) ? "\r" : "\n";
     return ending;
   }
   return "";
@@ -2025,7 +2273,7 @@ var _sync3 = require('csv-stringify/sync');
 
 function detectKeyColumnName(csvString) {
   const row = _sync.parse.call(void 0, csvString)[0];
-  const firstColumn = _optionalChain([row, 'optionalAccess', _88 => _88[0], 'optionalAccess', _89 => _89.trim, 'call', _90 => _90()]);
+  const firstColumn = _optionalChain([row, 'optionalAccess', _93 => _93[0], 'optionalAccess', _94 => _94.trim, 'call', _95 => _95()]);
   return firstColumn || "KEY";
 }
 function createCsvLoader() {
@@ -2127,7 +2375,7 @@ function createHtmlLoader() {
             break;
           }
           const siblings = Array.from(parent.childNodes).filter(
-            (n) => n.nodeType === 1 || n.nodeType === 3 && _optionalChain([n, 'access', _91 => _91.textContent, 'optionalAccess', _92 => _92.trim, 'call', _93 => _93()])
+            (n) => n.nodeType === 1 || n.nodeType === 3 && _optionalChain([n, 'access', _96 => _96.textContent, 'optionalAccess', _97 => _97.trim, 'call', _98 => _98()])
           );
           const index = siblings.indexOf(current);
           if (index !== -1) {
@@ -2163,15 +2411,15 @@ function createHtmlLoader() {
             }
           });
           Array.from(element.childNodes).filter(
-            (n) => n.nodeType === 1 || n.nodeType === 3 && _optionalChain([n, 'access', _94 => _94.textContent, 'optionalAccess', _95 => _95.trim, 'call', _96 => _96()])
+            (n) => n.nodeType === 1 || n.nodeType === 3 && _optionalChain([n, 'access', _99 => _99.textContent, 'optionalAccess', _100 => _100.trim, 'call', _101 => _101()])
           ).forEach(processNode);
         }
       };
       Array.from(document.head.childNodes).filter(
-        (n) => n.nodeType === 1 || n.nodeType === 3 && _optionalChain([n, 'access', _97 => _97.textContent, 'optionalAccess', _98 => _98.trim, 'call', _99 => _99()])
+        (n) => n.nodeType === 1 || n.nodeType === 3 && _optionalChain([n, 'access', _102 => _102.textContent, 'optionalAccess', _103 => _103.trim, 'call', _104 => _104()])
       ).forEach(processNode);
       Array.from(document.body.childNodes).filter(
-        (n) => n.nodeType === 1 || n.nodeType === 3 && _optionalChain([n, 'access', _100 => _100.textContent, 'optionalAccess', _101 => _101.trim, 'call', _102 => _102()])
+        (n) => n.nodeType === 1 || n.nodeType === 3 && _optionalChain([n, 'access', _105 => _105.textContent, 'optionalAccess', _106 => _106.trim, 'call', _107 => _107()])
       ).forEach(processNode);
       return result;
     },
@@ -2196,7 +2444,7 @@ function createHtmlLoader() {
         for (let i = 0; i < indices.length; i++) {
           const index = parseInt(indices[i]);
           const siblings = Array.from(parent.childNodes).filter(
-            (n) => n.nodeType === 1 || n.nodeType === 3 && _optionalChain([n, 'access', _103 => _103.textContent, 'optionalAccess', _104 => _104.trim, 'call', _105 => _105()])
+            (n) => n.nodeType === 1 || n.nodeType === 3 && _optionalChain([n, 'access', _108 => _108.textContent, 'optionalAccess', _109 => _109.trim, 'call', _110 => _110()])
           );
           if (index >= siblings.length) {
             if (i === indices.length - 1) {
@@ -2247,7 +2495,7 @@ function createMarkdownLoader() {
           yaml: yamlEngine
         }
       });
-      const sections = content.split(SECTION_REGEX).map((section) => _nullishCoalesce(_optionalChain([section, 'optionalAccess', _106 => _106.trim, 'call', _107 => _107()]), () => ( ""))).filter(Boolean);
+      const sections = content.split(SECTION_REGEX).map((section) => _nullishCoalesce(_optionalChain([section, 'optionalAccess', _111 => _111.trim, 'call', _112 => _112()]), () => ( ""))).filter(Boolean);
       return {
         ...Object.fromEntries(
           sections.map((section, index) => [`${MD_SECTION_PREFIX}${index}`, section]).filter(([, section]) => Boolean(section))
@@ -2266,7 +2514,7 @@ function createMarkdownLoader() {
       );
       let content = Object.entries(data).filter(([key]) => key.startsWith(MD_SECTION_PREFIX)).sort(
         ([a], [b]) => Number(a.split("-").pop()) - Number(b.split("-").pop())
-      ).map(([, value]) => _nullishCoalesce(_optionalChain([value, 'optionalAccess', _108 => _108.trim, 'call', _109 => _109()]), () => ( ""))).filter(Boolean).join("\n\n");
+      ).map(([, value]) => _nullishCoalesce(_optionalChain([value, 'optionalAccess', _113 => _113.trim, 'call', _114 => _114()]), () => ( ""))).filter(Boolean).join("\n\n");
       if (Object.keys(frontmatter).length > 0) {
         content = `
 ${content}`;
@@ -2310,7 +2558,7 @@ function isSkippableLine(line) {
 function parsePropertyLine(line) {
   const [key, ...valueParts] = line.split("=");
   return {
-    key: _optionalChain([key, 'optionalAccess', _110 => _110.trim, 'call', _111 => _111()]) || "",
+    key: _optionalChain([key, 'optionalAccess', _115 => _115.trim, 'call', _116 => _116()]) || "",
     value: valueParts.join("=").trim()
   };
 }
@@ -2398,7 +2646,7 @@ function createXcodeXcstringsLoader(defaultLocale) {
         if (rootTranslationEntity.shouldTranslate === false) {
           continue;
         }
-        const langTranslationEntity = _optionalChain([rootTranslationEntity, 'optionalAccess', _112 => _112.localizations, 'optionalAccess', _113 => _113[locale]]);
+        const langTranslationEntity = _optionalChain([rootTranslationEntity, 'optionalAccess', _117 => _117.localizations, 'optionalAccess', _118 => _118[locale]]);
         if (langTranslationEntity) {
           if ("stringUnit" in langTranslationEntity) {
             resultData[translationKey] = langTranslationEntity.stringUnit.value;
@@ -2407,7 +2655,7 @@ function createXcodeXcstringsLoader(defaultLocale) {
               resultData[translationKey] = {};
               const pluralForms = langTranslationEntity.variations.plural;
               for (const form in pluralForms) {
-                if (_optionalChain([pluralForms, 'access', _114 => _114[form], 'optionalAccess', _115 => _115.stringUnit, 'optionalAccess', _116 => _116.value])) {
+                if (_optionalChain([pluralForms, 'access', _119 => _119[form], 'optionalAccess', _120 => _120.stringUnit, 'optionalAccess', _121 => _121.value])) {
                   resultData[translationKey][form] = pluralForms[form].stringUnit.value;
                 }
               }
@@ -2433,7 +2681,7 @@ function createXcodeXcstringsLoader(defaultLocale) {
         const hasDoNotTranslateFlag = originalInput && originalInput.strings && originalInput.strings[key] && originalInput.strings[key].shouldTranslate === false;
         if (typeof value === "string") {
           langDataToMerge.strings[key] = {
-            extractionState: _optionalChain([originalInput, 'optionalAccess', _117 => _117.strings, 'optionalAccess', _118 => _118[key], 'optionalAccess', _119 => _119.extractionState]),
+            extractionState: _optionalChain([originalInput, 'optionalAccess', _122 => _122.strings, 'optionalAccess', _123 => _123[key], 'optionalAccess', _124 => _124.extractionState]),
             localizations: {
               [locale]: {
                 stringUnit: {
@@ -2474,6 +2722,36 @@ function createXcodeXcstringsLoader(defaultLocale) {
       const originalInputWithoutLocale = originalInput ? _removeLocale(originalInput, locale) : {};
       const result = _lodash2.default.merge({}, originalInputWithoutLocale, langDataToMerge);
       return result;
+    },
+    async pullHints(originalInput) {
+      if (!originalInput || !originalInput.strings) {
+        return {};
+      }
+      const hints = {};
+      for (const [translationKey, translationEntity] of Object.entries(
+        originalInput.strings
+      )) {
+        const entity = translationEntity;
+        if (entity.comment && typeof entity.comment === "string") {
+          hints[translationKey] = { hint: entity.comment };
+        }
+        if (entity.localizations) {
+          for (const [locale, localization] of Object.entries(
+            entity.localizations
+          )) {
+            if (_optionalChain([localization, 'access', _125 => _125.variations, 'optionalAccess', _126 => _126.plural])) {
+              const pluralForms = localization.variations.plural;
+              for (const form in pluralForms) {
+                const pluralKey = `${translationKey}/${form}`;
+                if (entity.comment && typeof entity.comment === "string") {
+                  hints[pluralKey] = { hint: entity.comment };
+                }
+              }
+            }
+          }
+        }
+      }
+      return hints;
     }
   });
 }
@@ -2481,7 +2759,7 @@ function _removeLocale(input2, locale) {
   const { strings } = input2;
   const newStrings = _lodash2.default.cloneDeep(strings);
   for (const [key, value] of Object.entries(newStrings)) {
-    if (_optionalChain([value, 'access', _120 => _120.localizations, 'optionalAccess', _121 => _121[locale]])) {
+    if (_optionalChain([value, 'access', _127 => _127.localizations, 'optionalAccess', _128 => _128[locale]])) {
       delete value.localizations[locale];
     }
   }
@@ -2641,7 +2919,7 @@ function createPoDataLoader(params) {
         Object.entries(entries).forEach(([msgid, entry]) => {
           if (msgid && entry.msgid) {
             const context = entry.msgctxt || "";
-            const fullEntry = _optionalChain([parsedPo, 'access', _122 => _122.translations, 'access', _123 => _123[context], 'optionalAccess', _124 => _124[msgid]]);
+            const fullEntry = _optionalChain([parsedPo, 'access', _129 => _129.translations, 'access', _130 => _130[context], 'optionalAccess', _131 => _131[msgid]]);
             if (fullEntry) {
               result[msgid] = fullEntry;
             }
@@ -2651,8 +2929,8 @@ function createPoDataLoader(params) {
       return result;
     },
     async push(locale, data, originalInput, originalLocale, pullInput) {
-      const currentSections = _optionalChain([pullInput, 'optionalAccess', _125 => _125.split, 'call', _126 => _126("\n\n"), 'access', _127 => _127.filter, 'call', _128 => _128(Boolean)]) || [];
-      const originalSections = _optionalChain([originalInput, 'optionalAccess', _129 => _129.split, 'call', _130 => _130("\n\n"), 'access', _131 => _131.filter, 'call', _132 => _132(Boolean)]) || [];
+      const currentSections = _optionalChain([pullInput, 'optionalAccess', _132 => _132.split, 'call', _133 => _133("\n\n"), 'access', _134 => _134.filter, 'call', _135 => _135(Boolean)]) || [];
+      const originalSections = _optionalChain([originalInput, 'optionalAccess', _136 => _136.split, 'call', _137 => _137("\n\n"), 'access', _138 => _138.filter, 'call', _139 => _139(Boolean)]) || [];
       const result = originalSections.map((section) => {
         const sectionPo = _gettextparser2.default.po.parse(section);
         if (Object.keys(sectionPo.translations).length === 0) {
@@ -2721,8 +2999,8 @@ function createPoContentLoader() {
         {
           ...entry,
           msgstr: [
-            _optionalChain([data, 'access', _133 => _133[entry.msgid], 'optionalAccess', _134 => _134.singular]),
-            _optionalChain([data, 'access', _135 => _135[entry.msgid], 'optionalAccess', _136 => _136.plural]) || null
+            _optionalChain([data, 'access', _140 => _140[entry.msgid], 'optionalAccess', _141 => _141.singular]),
+            _optionalChain([data, 'access', _142 => _142[entry.msgid], 'optionalAccess', _143 => _143.plural]) || null
           ].filter(Boolean)
         }
       ]).fromPairs().value();
@@ -2844,7 +3122,7 @@ function pullV1(xliffElement, locale, originalLocale) {
     let key = getTransUnitKey(unit);
     if (!key) return;
     if (seenKeys.has(key)) {
-      const id = _optionalChain([unit, 'access', _137 => _137.getAttribute, 'call', _138 => _138("id"), 'optionalAccess', _139 => _139.trim, 'call', _140 => _140()]);
+      const id = _optionalChain([unit, 'access', _144 => _144.getAttribute, 'call', _145 => _145("id"), 'optionalAccess', _146 => _146.trim, 'call', _147 => _147()]);
       if (id) {
         key = `${key}#${id}`;
       } else {
@@ -2892,7 +3170,7 @@ function pushV1(dom, xliffElement, locale, translations, originalLocale, origina
     let key = getTransUnitKey(unit);
     if (!key) return;
     if (seenKeys.has(key)) {
-      const id = _optionalChain([unit, 'access', _141 => _141.getAttribute, 'call', _142 => _142("id"), 'optionalAccess', _143 => _143.trim, 'call', _144 => _144()]);
+      const id = _optionalChain([unit, 'access', _148 => _148.getAttribute, 'call', _149 => _149("id"), 'optionalAccess', _150 => _150.trim, 'call', _151 => _151()]);
       if (id) {
         key = `${key}#${id}`;
       } else {
@@ -2934,7 +3212,7 @@ function pushV1(dom, xliffElement, locale, translations, originalLocale, origina
   const translationKeys = new Set(Object.keys(translations));
   existingUnits.forEach((unit, key) => {
     if (!translationKeys.has(key)) {
-      _optionalChain([unit, 'access', _145 => _145.parentNode, 'optionalAccess', _146 => _146.removeChild, 'call', _147 => _147(unit)]);
+      _optionalChain([unit, 'access', _152 => _152.parentNode, 'optionalAccess', _153 => _153.removeChild, 'call', _154 => _154(unit)]);
     }
   });
   return serializeWithDeclaration(
@@ -2977,18 +3255,18 @@ function traverseUnitsV2(container, fileId, currentPath, result) {
   Array.from(container.children).forEach((child) => {
     const tagName = child.tagName;
     if (tagName === "unit") {
-      const unitId = _optionalChain([child, 'access', _148 => _148.getAttribute, 'call', _149 => _149("id"), 'optionalAccess', _150 => _150.trim, 'call', _151 => _151()]);
+      const unitId = _optionalChain([child, 'access', _155 => _155.getAttribute, 'call', _156 => _156("id"), 'optionalAccess', _157 => _157.trim, 'call', _158 => _158()]);
       if (!unitId) return;
       const key = `resources/${fileId}/${currentPath}${unitId}/source`;
       const segment = child.querySelector("segment");
-      const source = _optionalChain([segment, 'optionalAccess', _152 => _152.querySelector, 'call', _153 => _153("source")]);
+      const source = _optionalChain([segment, 'optionalAccess', _159 => _159.querySelector, 'call', _160 => _160("source")]);
       if (source) {
         result[key] = extractTextContent(source);
       } else {
         result[key] = unitId;
       }
     } else if (tagName === "group") {
-      const groupId = _optionalChain([child, 'access', _154 => _154.getAttribute, 'call', _155 => _155("id"), 'optionalAccess', _156 => _156.trim, 'call', _157 => _157()]);
+      const groupId = _optionalChain([child, 'access', _161 => _161.getAttribute, 'call', _162 => _162("id"), 'optionalAccess', _163 => _163.trim, 'call', _164 => _164()]);
       const newPath = groupId ? `${currentPath}${groupId}/groupUnits/` : currentPath;
       traverseUnitsV2(child, fileId, newPath, result);
     }
@@ -3024,12 +3302,12 @@ function indexUnitsV2(container, fileId, currentPath, index) {
   Array.from(container.children).forEach((child) => {
     const tagName = child.tagName;
     if (tagName === "unit") {
-      const unitId = _optionalChain([child, 'access', _158 => _158.getAttribute, 'call', _159 => _159("id"), 'optionalAccess', _160 => _160.trim, 'call', _161 => _161()]);
+      const unitId = _optionalChain([child, 'access', _165 => _165.getAttribute, 'call', _166 => _166("id"), 'optionalAccess', _167 => _167.trim, 'call', _168 => _168()]);
       if (!unitId) return;
       const key = `resources/${fileId}/${currentPath}${unitId}/source`;
       index.set(key, child);
     } else if (tagName === "group") {
-      const groupId = _optionalChain([child, 'access', _162 => _162.getAttribute, 'call', _163 => _163("id"), 'optionalAccess', _164 => _164.trim, 'call', _165 => _165()]);
+      const groupId = _optionalChain([child, 'access', _169 => _169.getAttribute, 'call', _170 => _170("id"), 'optionalAccess', _171 => _171.trim, 'call', _172 => _172()]);
       const newPath = groupId ? `${currentPath}${groupId}/groupUnits/` : currentPath;
       indexUnitsV2(child, fileId, newPath, index);
     }
@@ -3050,9 +3328,9 @@ function updateUnitV2(unit, value) {
   setTextContent(source, value);
 }
 function getTransUnitKey(transUnit) {
-  const resname = _optionalChain([transUnit, 'access', _166 => _166.getAttribute, 'call', _167 => _167("resname"), 'optionalAccess', _168 => _168.trim, 'call', _169 => _169()]);
+  const resname = _optionalChain([transUnit, 'access', _173 => _173.getAttribute, 'call', _174 => _174("resname"), 'optionalAccess', _175 => _175.trim, 'call', _176 => _176()]);
   if (resname) return resname;
-  const id = _optionalChain([transUnit, 'access', _170 => _170.getAttribute, 'call', _171 => _171("id"), 'optionalAccess', _172 => _172.trim, 'call', _173 => _173()]);
+  const id = _optionalChain([transUnit, 'access', _177 => _177.getAttribute, 'call', _178 => _178("id"), 'optionalAccess', _179 => _179.trim, 'call', _180 => _180()]);
   if (id) return id;
   const sourceElement = transUnit.querySelector("source");
   if (sourceElement) {
@@ -3109,7 +3387,7 @@ function formatXml(xml) {
     if (cdataNode) {
       return `${indent2}${openTag}<![CDATA[${cdataNode.nodeValue}]]></${tagName}>`;
     }
-    const textContent = _optionalChain([element, 'access', _174 => _174.textContent, 'optionalAccess', _175 => _175.trim, 'call', _176 => _176()]) || "";
+    const textContent = _optionalChain([element, 'access', _181 => _181.textContent, 'optionalAccess', _182 => _182.trim, 'call', _183 => _183()]) || "";
     const hasOnlyText = element.childNodes.length === 1 && element.childNodes[0].nodeType === 3;
     if (hasOnlyText && textContent) {
       return `${indent2}${openTag}${textContent}</${tagName}>`;
@@ -3238,7 +3516,7 @@ function createSrtLoader() {
 
 // src/cli/loaders/dato/index.ts
 
-var _json5 = require('json5'); var _json52 = _interopRequireDefault(_json5);
+
 
 // src/cli/loaders/dato/_base.ts
 
@@ -3402,7 +3680,7 @@ function createDatoClient(params) {
           ids: !records.length ? void 0 : records.join(",")
         }
       }).catch(
-        (error) => Promise.reject(_optionalChain([error, 'optionalAccess', _177 => _177.response, 'optionalAccess', _178 => _178.body, 'optionalAccess', _179 => _179.data, 'optionalAccess', _180 => _180[0]]) || error)
+        (error) => Promise.reject(_optionalChain([error, 'optionalAccess', _184 => _184.response, 'optionalAccess', _185 => _185.body, 'optionalAccess', _186 => _186.data, 'optionalAccess', _187 => _187[0]]) || error)
       );
     },
     findRecordsForModel: async (modelId, records) => {
@@ -3413,10 +3691,10 @@ function createDatoClient(params) {
           filter: {
             type: modelId,
             only_valid: "true",
-            ids: !_optionalChain([records, 'optionalAccess', _181 => _181.length]) ? void 0 : records.join(",")
+            ids: !_optionalChain([records, 'optionalAccess', _188 => _188.length]) ? void 0 : records.join(",")
           }
         }).catch(
-          (error) => Promise.reject(_optionalChain([error, 'optionalAccess', _182 => _182.response, 'optionalAccess', _183 => _183.body, 'optionalAccess', _184 => _184.data, 'optionalAccess', _185 => _185[0]]) || error)
+          (error) => Promise.reject(_optionalChain([error, 'optionalAccess', _189 => _189.response, 'optionalAccess', _190 => _190.body, 'optionalAccess', _191 => _191.data, 'optionalAccess', _192 => _192[0]]) || error)
         );
         return result;
       } catch (_error) {
@@ -3432,10 +3710,10 @@ function createDatoClient(params) {
     updateRecord: async (id, payload) => {
       try {
         await dato.items.update(id, payload).catch(
-          (error) => Promise.reject(_optionalChain([error, 'optionalAccess', _186 => _186.response, 'optionalAccess', _187 => _187.body, 'optionalAccess', _188 => _188.data, 'optionalAccess', _189 => _189[0]]) || error)
+          (error) => Promise.reject(_optionalChain([error, 'optionalAccess', _193 => _193.response, 'optionalAccess', _194 => _194.body, 'optionalAccess', _195 => _195.data, 'optionalAccess', _196 => _196[0]]) || error)
         );
       } catch (_error) {
-        if (_optionalChain([_error, 'optionalAccess', _190 => _190.attributes, 'optionalAccess', _191 => _191.details, 'optionalAccess', _192 => _192.message])) {
+        if (_optionalChain([_error, 'optionalAccess', _197 => _197.attributes, 'optionalAccess', _198 => _198.details, 'optionalAccess', _199 => _199.message])) {
           throw new Error(
             [
               `${_error.attributes.details.message}`,
@@ -3457,10 +3735,10 @@ function createDatoClient(params) {
     enableFieldLocalization: async (args) => {
       try {
         await dato.fields.update(`${args.modelId}::${args.fieldId}`, { localized: true }).catch(
-          (error) => Promise.reject(_optionalChain([error, 'optionalAccess', _193 => _193.response, 'optionalAccess', _194 => _194.body, 'optionalAccess', _195 => _195.data, 'optionalAccess', _196 => _196[0]]) || error)
+          (error) => Promise.reject(_optionalChain([error, 'optionalAccess', _200 => _200.response, 'optionalAccess', _201 => _201.body, 'optionalAccess', _202 => _202.data, 'optionalAccess', _203 => _203[0]]) || error)
         );
       } catch (_error) {
-        if (_optionalChain([_error, 'optionalAccess', _197 => _197.attributes, 'optionalAccess', _198 => _198.code]) === "NOT_FOUND") {
+        if (_optionalChain([_error, 'optionalAccess', _204 => _204.attributes, 'optionalAccess', _205 => _205.code]) === "NOT_FOUND") {
           throw new Error(
             [
               `Field "${args.fieldId}" not found in model "${args.modelId}".`,
@@ -3468,7 +3746,7 @@ function createDatoClient(params) {
             ].join("\n\n")
           );
         }
-        if (_optionalChain([_error, 'optionalAccess', _199 => _199.attributes, 'optionalAccess', _200 => _200.details, 'optionalAccess', _201 => _201.message])) {
+        if (_optionalChain([_error, 'optionalAccess', _206 => _206.attributes, 'optionalAccess', _207 => _207.details, 'optionalAccess', _208 => _208.message])) {
           throw new Error(
             [
               `${_error.attributes.details.message}`,
@@ -3546,7 +3824,7 @@ function createDatoApiLoader(config, onConfigUpdate) {
           const records = await dato.findRecordsForModel(modelId);
           const recordChoices = createRecordChoices(
             records,
-            _optionalChain([config, 'access', _202 => _202.models, 'access', _203 => _203[modelId], 'optionalAccess', _204 => _204.records]) || [],
+            _optionalChain([config, 'access', _209 => _209.models, 'access', _210 => _210[modelId], 'optionalAccess', _211 => _211.records]) || [],
             project
           );
           const selectedRecords = await promptRecordSelection(
@@ -3565,14 +3843,14 @@ function createDatoApiLoader(config, onConfigUpdate) {
     },
     async pull(locale, input2, initCtx) {
       const result = {};
-      for (const modelId of _lodash2.default.keys(_optionalChain([initCtx, 'optionalAccess', _205 => _205.models]) || {})) {
-        let records = _optionalChain([initCtx, 'optionalAccess', _206 => _206.models, 'access', _207 => _207[modelId], 'access', _208 => _208.records]) || [];
+      for (const modelId of _lodash2.default.keys(_optionalChain([initCtx, 'optionalAccess', _212 => _212.models]) || {})) {
+        let records = _optionalChain([initCtx, 'optionalAccess', _213 => _213.models, 'access', _214 => _214[modelId], 'access', _215 => _215.records]) || [];
         const recordIds = records.map((record) => record.id);
         records = await dato.findRecords(recordIds);
         console.log(`Fetched ${records.length} records for model ${modelId}`);
         if (records.length > 0) {
           result[modelId] = {
-            fields: _optionalChain([initCtx, 'optionalAccess', _209 => _209.models, 'optionalAccess', _210 => _210[modelId], 'optionalAccess', _211 => _211.fields]) || [],
+            fields: _optionalChain([initCtx, 'optionalAccess', _216 => _216.models, 'optionalAccess', _217 => _217[modelId], 'optionalAccess', _218 => _218.fields]) || [],
             records
           };
         }
@@ -3635,7 +3913,7 @@ function createRecordChoices(records, selectedIds = [], project) {
   return records.map((record) => ({
     name: `${record.id} - https://${project.internal_domain}/editor/item_types/${record.item_type.id}/items/${record.id}`,
     value: record.id,
-    checked: _optionalChain([selectedIds, 'optionalAccess', _212 => _212.includes, 'call', _213 => _213(record.id)])
+    checked: _optionalChain([selectedIds, 'optionalAccess', _219 => _219.includes, 'call', _220 => _220(record.id)])
   }));
 }
 async function promptRecordSelection(modelName, choices) {
@@ -3954,7 +4232,7 @@ function createVttLoader() {
       if (!input2) {
         return "";
       }
-      const vtt = _optionalChain([_nodewebvtt2.default, 'access', _214 => _214.parse, 'call', _215 => _215(input2), 'optionalAccess', _216 => _216.cues]);
+      const vtt = _optionalChain([_nodewebvtt2.default, 'access', _221 => _221.parse, 'call', _222 => _222(input2), 'optionalAccess', _223 => _223.cues]);
       if (Object.keys(vtt).length === 0) {
         return {};
       } else {
@@ -4008,7 +4286,7 @@ function variableExtractLoader(params) {
         for (let i = 0; i < matches.length; i++) {
           const match2 = matches[i];
           const currentValue = result[key].value;
-          const newValue = _optionalChain([currentValue, 'optionalAccess', _217 => _217.replace, 'call', _218 => _218(match2, `{variable:${i}}`)]);
+          const newValue = _optionalChain([currentValue, 'optionalAccess', _224 => _224.replace, 'call', _225 => _225(match2, `{variable:${i}}`)]);
           result[key].value = newValue;
           result[key].variables[i] = match2;
         }
@@ -4022,7 +4300,7 @@ function variableExtractLoader(params) {
         for (let i = 0; i < valueObj.variables.length; i++) {
           const variable = valueObj.variables[i];
           const currentValue = result[key];
-          const newValue = _optionalChain([currentValue, 'optionalAccess', _219 => _219.replace, 'call', _220 => _220(`{variable:${i}}`, variable)]);
+          const newValue = _optionalChain([currentValue, 'optionalAccess', _226 => _226.replace, 'call', _227 => _227(`{variable:${i}}`, variable)]);
           result[key] = newValue;
         }
       }
@@ -4222,7 +4500,7 @@ function createVueJsonLoader() {
   return createLoader({
     pull: async (locale, input2, ctx) => {
       const parsed = parseVueFile(input2);
-      return _nullishCoalesce(_optionalChain([parsed, 'optionalAccess', _221 => _221.i18n, 'optionalAccess', _222 => _222[locale]]), () => ( {}));
+      return _nullishCoalesce(_optionalChain([parsed, 'optionalAccess', _228 => _228.i18n, 'optionalAccess', _229 => _229[locale]]), () => ( {}));
     },
     push: async (locale, data, originalInput) => {
       const parsed = parseVueFile(_nullishCoalesce(originalInput, () => ( "")));
@@ -4407,7 +4685,7 @@ function updateStringsInObjectExpression(objectExpression, data) {
   objectExpression.properties.forEach((prop) => {
     if (!t.isObjectProperty(prop)) return;
     const key = getPropertyKey(prop);
-    const incomingVal = _optionalChain([data, 'optionalAccess', _223 => _223[key]]);
+    const incomingVal = _optionalChain([data, 'optionalAccess', _230 => _230[key]]);
     if (incomingVal === void 0) {
       return;
     }
@@ -4443,7 +4721,7 @@ function updateStringsInArrayExpression(arrayExpression, incoming) {
   let modified = false;
   arrayExpression.elements.forEach((element, index) => {
     if (!element) return;
-    const incomingVal = _optionalChain([incoming, 'optionalAccess', _224 => _224[index]]);
+    const incomingVal = _optionalChain([incoming, 'optionalAccess', _231 => _231[index]]);
     if (incomingVal === void 0) return;
     if (t.isStringLiteral(element) && typeof incomingVal === "string") {
       if (element.value !== incomingVal) {
@@ -4934,7 +5212,7 @@ var AST = class _AST {
     const ret = this.type === null ? this.#parts.slice().map((p) => typeof p === "string" ? p : p.toJSON()) : [this.type, ...this.#parts.map((p) => p.toJSON())];
     if (this.isStart() && !this.type)
       ret.unshift([]);
-    if (this.isEnd() && (this === this.#root || this.#root.#filledNegs && _optionalChain([this, 'access', _225 => _225.#parent, 'optionalAccess', _226 => _226.type]) === "!")) {
+    if (this.isEnd() && (this === this.#root || this.#root.#filledNegs && _optionalChain([this, 'access', _232 => _232.#parent, 'optionalAccess', _233 => _233.type]) === "!")) {
       ret.push({});
     }
     return ret;
@@ -4942,7 +5220,7 @@ var AST = class _AST {
   isStart() {
     if (this.#root === this)
       return true;
-    if (!_optionalChain([this, 'access', _227 => _227.#parent, 'optionalAccess', _228 => _228.isStart, 'call', _229 => _229()]))
+    if (!_optionalChain([this, 'access', _234 => _234.#parent, 'optionalAccess', _235 => _235.isStart, 'call', _236 => _236()]))
       return false;
     if (this.#parentIndex === 0)
       return true;
@@ -4958,12 +5236,12 @@ var AST = class _AST {
   isEnd() {
     if (this.#root === this)
       return true;
-    if (_optionalChain([this, 'access', _230 => _230.#parent, 'optionalAccess', _231 => _231.type]) === "!")
+    if (_optionalChain([this, 'access', _237 => _237.#parent, 'optionalAccess', _238 => _238.type]) === "!")
       return true;
-    if (!_optionalChain([this, 'access', _232 => _232.#parent, 'optionalAccess', _233 => _233.isEnd, 'call', _234 => _234()]))
+    if (!_optionalChain([this, 'access', _239 => _239.#parent, 'optionalAccess', _240 => _240.isEnd, 'call', _241 => _241()]))
       return false;
     if (!this.type)
-      return _optionalChain([this, 'access', _235 => _235.#parent, 'optionalAccess', _236 => _236.isEnd, 'call', _237 => _237()]);
+      return _optionalChain([this, 'access', _242 => _242.#parent, 'optionalAccess', _243 => _243.isEnd, 'call', _244 => _244()]);
     const pl = this.#parent ? this.#parent.#parts.length : 0;
     return this.#parentIndex === pl - 1;
   }
@@ -5208,7 +5486,7 @@ var AST = class _AST {
         }
       }
       let end = "";
-      if (this.isEnd() && this.#root.#filledNegs && _optionalChain([this, 'access', _238 => _238.#parent, 'optionalAccess', _239 => _239.type]) === "!") {
+      if (this.isEnd() && this.#root.#filledNegs && _optionalChain([this, 'access', _245 => _245.#parent, 'optionalAccess', _246 => _246.type]) === "!") {
         end = "(?:$|\\/)";
       }
       const final2 = start2 + src + end;
@@ -6285,7 +6563,7 @@ function createMdxSectionsSplit2Loader() {
       const content = _lodash2.default.chain(data.sections).values().join("\n\n").value();
       const result = {
         frontmatter: data.frontmatter,
-        codePlaceholders: _optionalChain([pullInput, 'optionalAccess', _240 => _240.codePlaceholders]) || {},
+        codePlaceholders: _optionalChain([pullInput, 'optionalAccess', _247 => _247.codePlaceholders]) || {},
         content
       };
       return result;
@@ -6702,6 +6980,28 @@ function createBucketLoader(bucketType, bucketPathPattern, options, lockedKeys,
         createSyncLoader(),
         createUnlocalizableLoader(options.returnUnlocalizedKeys)
       );
+    case "json5":
+      return composeLoaders(
+        createTextFileLoader(bucketPathPattern),
+        createJson5Loader(),
+        createEnsureKeyOrderLoader(),
+        createFlatLoader(),
+        createInjectLocaleLoader(options.injectLocale),
+        createLockedKeysLoader(lockedKeys || []),
+        createSyncLoader(),
+        createUnlocalizableLoader(options.returnUnlocalizedKeys)
+      );
+    case "jsonc":
+      return composeLoaders(
+        createTextFileLoader(bucketPathPattern),
+        createJsoncLoader(),
+        createEnsureKeyOrderLoader(),
+        createFlatLoader(),
+        createInjectLocaleLoader(options.injectLocale),
+        createLockedKeysLoader(lockedKeys || []),
+        createSyncLoader(),
+        createUnlocalizableLoader(options.returnUnlocalizedKeys)
+      );
     case "markdown":
       return composeLoaders(
         createTextFileLoader(bucketPathPattern),
@@ -7000,7 +7300,7 @@ function createBasicTranslator(model, systemPrompt) {
       ]
     });
     const result = JSON.parse(response.text);
-    return _optionalChain([result, 'optionalAccess', _241 => _241.data]) || {};
+    return _optionalChain([result, 'optionalAccess', _248 => _248.data]) || {};
   }
 }
 function extractPayloadChunks(payload) {
@@ -7082,7 +7382,7 @@ function getPureModelProvider(provider) {
 
   ${_chalk2.default.hex(colors.blue)("Docs: https://lingo.dev/go/docs")}
   `;
-  switch (_optionalChain([provider, 'optionalAccess', _242 => _242.id])) {
+  switch (_optionalChain([provider, 'optionalAccess', _249 => _249.id])) {
     case "openai": {
       if (!process.env.OPENAI_API_KEY) {
         throw new Error(
@@ -7140,7 +7440,7 @@ function getPureModelProvider(provider) {
       })(provider.model);
     }
     default: {
-      throw new Error(createUnsupportedProviderErrorMessage(_optionalChain([provider, 'optionalAccess', _243 => _243.id])));
+      throw new Error(createUnsupportedProviderErrorMessage(_optionalChain([provider, 'optionalAccess', _250 => _250.id])));
     }
   }
 }
@@ -7380,7 +7680,7 @@ var i18n_default = new (0, _interactivecommander.Command)().command("i18n").desc
     validateParams(i18nConfig, flags);
     ora.succeed("Localization configuration is valid");
     ora.start("Connecting to Lingo.dev Localization Engine...");
-    const isByokMode = !!_optionalChain([i18nConfig, 'optionalAccess', _244 => _244.provider]);
+    const isByokMode = !!_optionalChain([i18nConfig, 'optionalAccess', _251 => _251.provider]);
     if (isByokMode) {
       authId = null;
       ora.succeed("Using external provider (BYOK mode)");
@@ -7394,16 +7694,16 @@ var i18n_default = new (0, _interactivecommander.Command)().command("i18n").desc
       flags
     });
     let buckets = getBuckets(i18nConfig);
-    if (_optionalChain([flags, 'access', _245 => _245.bucket, 'optionalAccess', _246 => _246.length])) {
+    if (_optionalChain([flags, 'access', _252 => _252.bucket, 'optionalAccess', _253 => _253.length])) {
       buckets = buckets.filter(
         (bucket) => flags.bucket.includes(bucket.type)
       );
     }
     ora.succeed("Buckets retrieved");
-    if (_optionalChain([flags, 'access', _247 => _247.file, 'optionalAccess', _248 => _248.length])) {
+    if (_optionalChain([flags, 'access', _254 => _254.file, 'optionalAccess', _255 => _255.length])) {
       buckets = buckets.map((bucket) => {
         const paths = bucket.paths.filter(
-          (path17) => flags.file.find((file) => _optionalChain([path17, 'access', _249 => _249.pathPattern, 'optionalAccess', _250 => _250.includes, 'call', _251 => _251(file)]))
+          (path17) => flags.file.find((file) => _optionalChain([path17, 'access', _256 => _256.pathPattern, 'optionalAccess', _257 => _257.includes, 'call', _258 => _258(file)]))
         );
         return { ...bucket, paths };
       }).filter((bucket) => bucket.paths.length > 0);
@@ -7422,7 +7722,7 @@ var i18n_default = new (0, _interactivecommander.Command)().command("i18n").desc
         });
       }
     }
-    const targetLocales = _optionalChain([flags, 'access', _252 => _252.locale, 'optionalAccess', _253 => _253.length]) ? flags.locale : i18nConfig.locale.targets;
+    const targetLocales = _optionalChain([flags, 'access', _259 => _259.locale, 'optionalAccess', _260 => _260.length]) ? flags.locale : i18nConfig.locale.targets;
     ora.start("Setting up localization cache...");
     const checkLockfileProcessor = createDeltaProcessor("");
     const lockfileExists = await checkLockfileProcessor.checkIfLockExists();
@@ -7681,7 +7981,7 @@ var i18n_default = new (0, _interactivecommander.Command)().command("i18n").desc
           }
           const deltaProcessor = createDeltaProcessor(bucketPath.pathPattern);
           const checksums = await deltaProcessor.createChecksums(sourceData);
-          if (!_optionalChain([flags, 'access', _254 => _254.locale, 'optionalAccess', _255 => _255.length])) {
+          if (!_optionalChain([flags, 'access', _261 => _261.locale, 'optionalAccess', _262 => _262.length])) {
             await deltaProcessor.saveChecksums(checksums);
           }
         }
@@ -7765,12 +8065,12 @@ function validateParams(i18nConfig, flags) {
       message: "No buckets found in i18n.json. Please add at least one bucket containing i18n content.",
       docUrl: "bucketNotFound"
     });
-  } else if (_optionalChain([flags, 'access', _256 => _256.locale, 'optionalAccess', _257 => _257.some, 'call', _258 => _258((locale) => !i18nConfig.locale.targets.includes(locale))])) {
+  } else if (_optionalChain([flags, 'access', _263 => _263.locale, 'optionalAccess', _264 => _264.some, 'call', _265 => _265((locale) => !i18nConfig.locale.targets.includes(locale))])) {
     throw new CLIError({
       message: `One or more specified locales do not exist in i18n.json locale.targets. Please add them to the list and try again.`,
       docUrl: "localeTargetNotFound"
     });
-  } else if (_optionalChain([flags, 'access', _259 => _259.bucket, 'optionalAccess', _260 => _260.some, 'call', _261 => _261(
+  } else if (_optionalChain([flags, 'access', _266 => _266.bucket, 'optionalAccess', _267 => _267.some, 'call', _268 => _268(
     (bucket) => !i18nConfig.buckets[bucket]
   )])) {
     throw new CLIError({
@@ -8274,7 +8574,7 @@ function createLingoDotDevLocalizer(explicitApiKey) {
         const response = await engine.whoami();
         return {
           authenticated: !!response,
-          username: _optionalChain([response, 'optionalAccess', _262 => _262.email])
+          username: _optionalChain([response, 'optionalAccess', _269 => _269.email])
         };
       } catch (e2) {
         return { authenticated: false };
@@ -8292,7 +8592,8 @@ function createLingoDotDevLocalizer(explicitApiKey) {
           reference: {
             [input2.sourceLocale]: input2.sourceData,
             [input2.targetLocale]: input2.targetData
-          }
+          },
+          hints: input2.hints
         },
         onProgress
       );
@@ -8381,7 +8682,7 @@ function createExplicitLocalizer(provider) {
 }
 function createAiSdkLocalizer(params) {
   const skipAuth = params.skipAuth === true;
-  const apiKey = process.env[_nullishCoalesce(_optionalChain([params, 'optionalAccess', _263 => _263.apiKeyName]), () => ( ""))];
+  const apiKey = process.env[_nullishCoalesce(_optionalChain([params, 'optionalAccess', _270 => _270.apiKeyName]), () => ( ""))];
   if (!skipAuth && !apiKey || !params.apiKeyName) {
     throw new Error(
       _dedent2.default`
@@ -8506,8 +8807,8 @@ async function setup(input2) {
             throw new Error(
               "No buckets found in i18n.json. Please add at least one bucket containing i18n content."
             );
-          } else if (_optionalChain([ctx, 'access', _264 => _264.flags, 'access', _265 => _265.bucket, 'optionalAccess', _266 => _266.some, 'call', _267 => _267(
-            (bucket) => !_optionalChain([ctx, 'access', _268 => _268.config, 'optionalAccess', _269 => _269.buckets, 'access', _270 => _270[bucket]])
+          } else if (_optionalChain([ctx, 'access', _271 => _271.flags, 'access', _272 => _272.bucket, 'optionalAccess', _273 => _273.some, 'call', _274 => _274(
+            (bucket) => !_optionalChain([ctx, 'access', _275 => _275.config, 'optionalAccess', _276 => _276.buckets, 'access', _277 => _277[bucket]])
           )])) {
             throw new Error(
               `One or more specified buckets do not exist in i18n.json. Please add them to the list first and try again.`
@@ -8520,7 +8821,7 @@ async function setup(input2) {
         title: "Selecting localization provider",
         task: async (ctx, task) => {
           ctx.localizer = createLocalizer(
-            _optionalChain([ctx, 'access', _271 => _271.config, 'optionalAccess', _272 => _272.provider]),
+            _optionalChain([ctx, 'access', _278 => _278.config, 'optionalAccess', _279 => _279.provider]),
             ctx.flags.apiKey
           );
           if (!ctx.localizer) {
@@ -8826,6 +9127,7 @@ function createWorkerTask(args) {
             const sourceData = await bucketLoader.pull(
               assignedTask.sourceLocale
             );
+            const hints = await bucketLoader.pullHints();
             const targetData = await bucketLoader.pull(
               assignedTask.targetLocale
             );
@@ -8838,7 +9140,7 @@ function createWorkerTask(args) {
             const processableData = _lodash2.default.chain(sourceData).entries().filter(
               ([key, value]) => delta.added.includes(key) || delta.updated.includes(key) || !!args.ctx.flags.force
             ).filter(
-              ([key]) => !assignedTask.onlyKeys.length || _optionalChain([assignedTask, 'access', _273 => _273.onlyKeys, 'optionalAccess', _274 => _274.some, 'call', _275 => _275(
+              ([key]) => !assignedTask.onlyKeys.length || _optionalChain([assignedTask, 'access', _280 => _280.onlyKeys, 'optionalAccess', _281 => _281.some, 'call', _282 => _282(
                 (pattern) => minimatch(key, pattern)
               )])
             ).fromPairs().value();
@@ -8848,13 +9150,15 @@ function createWorkerTask(args) {
               });
               return { status: "skipped" };
             }
+            const relevantHints = _lodash2.default.pick(hints, Object.keys(processableData));
             const processedTargetData = await args.ctx.localizer.localize(
               {
                 sourceLocale: assignedTask.sourceLocale,
                 targetLocale: assignedTask.targetLocale,
                 sourceData,
                 targetData,
-                processableData
+                processableData,
+                hints: relevantHints
               },
               async (progress, _sourceChunk, processedChunk) => {
                 await args.ioLimiter(async () => {
@@ -8899,7 +9203,7 @@ function createWorkerTask(args) {
                 finalRenamedTargetData
               );
               const checksums2 = await deltaProcessor.createChecksums(sourceData);
-              if (!_optionalChain([args, 'access', _276 => _276.ctx, 'access', _277 => _277.flags, 'access', _278 => _278.targetLocale, 'optionalAccess', _279 => _279.length])) {
+              if (!_optionalChain([args, 'access', _283 => _283.ctx, 'access', _284 => _284.flags, 'access', _285 => _285.targetLocale, 'optionalAccess', _286 => _286.length])) {
                 await deltaProcessor.saveChecksums(checksums2);
               }
             });
@@ -9089,13 +9393,13 @@ var flagsSchema2 = _zod.z.object({
 
 // src/cli/cmd/run/_utils.ts
 async function determineAuthId(ctx) {
-  const isByokMode = !!_optionalChain([ctx, 'access', _280 => _280.config, 'optionalAccess', _281 => _281.provider]);
+  const isByokMode = !!_optionalChain([ctx, 'access', _287 => _287.config, 'optionalAccess', _288 => _288.provider]);
   if (isByokMode) {
     return null;
   } else {
     try {
-      const authStatus = await _optionalChain([ctx, 'access', _282 => _282.localizer, 'optionalAccess', _283 => _283.checkAuth, 'call', _284 => _284()]);
-      return _optionalChain([authStatus, 'optionalAccess', _285 => _285.username]) || null;
+      const authStatus = await _optionalChain([ctx, 'access', _289 => _289.localizer, 'optionalAccess', _290 => _290.checkAuth, 'call', _291 => _291()]);
+      return _optionalChain([authStatus, 'optionalAccess', _292 => _292.username]) || null;
     } catch (e3) {
       return null;
     }
@@ -9255,7 +9559,7 @@ var InBranchFlow = class extends IntegrationFlow {
     _child_process.execSync.call(void 0, `git config --global safe.directory ${process.cwd()}`);
     _child_process.execSync.call(void 0, `git config user.name "${gitConfig.userName}"`);
     _child_process.execSync.call(void 0, `git config user.email "${gitConfig.userEmail}"`);
-    _optionalChain([this, 'access', _286 => _286.platformKit, 'optionalAccess', _287 => _287.gitConfig, 'call', _288 => _288()]);
+    _optionalChain([this, 'access', _293 => _293.platformKit, 'optionalAccess', _294 => _294.gitConfig, 'call', _295 => _295()]);
     _child_process.execSync.call(void 0, `git fetch origin ${baseBranchName}`, { stdio: "inherit" });
     _child_process.execSync.call(void 0, `git checkout ${baseBranchName} --`, { stdio: "inherit" });
     if (!processOwnCommits) {
@@ -9287,7 +9591,7 @@ var InBranchFlow = class extends IntegrationFlow {
 // src/cli/cmd/ci/flows/pull-request.ts
 var PullRequestFlow = class extends InBranchFlow {
   async preRun() {
-    const canContinue = await _optionalChain([super.preRun.bind(this), 'optionalCall', _289 => _289()]);
+    const canContinue = await _optionalChain([super.preRun.bind(this), 'optionalCall', _296 => _296()]);
     if (!canContinue) {
       return false;
     }
@@ -9550,10 +9854,10 @@ var BitbucketPlatformKit = class extends PlatformKit {
       repo_slug: this.platformConfig.repositoryName,
       state: "OPEN"
     }).then(({ data: { values } }) => {
-      return _optionalChain([values, 'optionalAccess', _290 => _290.find, 'call', _291 => _291(
-        ({ source, destination }) => _optionalChain([source, 'optionalAccess', _292 => _292.branch, 'optionalAccess', _293 => _293.name]) === branch && _optionalChain([destination, 'optionalAccess', _294 => _294.branch, 'optionalAccess', _295 => _295.name]) === this.platformConfig.baseBranchName
+      return _optionalChain([values, 'optionalAccess', _297 => _297.find, 'call', _298 => _298(
+        ({ source, destination }) => _optionalChain([source, 'optionalAccess', _299 => _299.branch, 'optionalAccess', _300 => _300.name]) === branch && _optionalChain([destination, 'optionalAccess', _301 => _301.branch, 'optionalAccess', _302 => _302.name]) === this.platformConfig.baseBranchName
       )]);
-    }).then((pr) => _optionalChain([pr, 'optionalAccess', _296 => _296.id]));
+    }).then((pr) => _optionalChain([pr, 'optionalAccess', _303 => _303.id]));
   }
   async closePullRequest({ pullRequestNumber }) {
     await this.bb.repositories.declinePullRequest({
@@ -9649,7 +9953,7 @@ var GitHubPlatformKit = class extends PlatformKit {
       repo: this.platformConfig.repositoryName,
       base: this.platformConfig.baseBranchName,
       state: "open"
-    }).then(({ data }) => data[0]).then((pr) => _optionalChain([pr, 'optionalAccess', _297 => _297.number]));
+    }).then(({ data }) => data[0]).then((pr) => _optionalChain([pr, 'optionalAccess', _304 => _304.number]));
   }
   async closePullRequest({ pullRequestNumber }) {
     await this.octokit.rest.pulls.update({
@@ -9776,7 +10080,7 @@ var GitlabPlatformKit = class extends PlatformKit {
       sourceBranch: branch,
       state: "opened"
     });
-    return _optionalChain([mergeRequests, 'access', _298 => _298[0], 'optionalAccess', _299 => _299.iid]);
+    return _optionalChain([mergeRequests, 'access', _305 => _305[0], 'optionalAccess', _306 => _306.iid]);
   }
   async closePullRequest({
     pullRequestNumber
@@ -9866,7 +10170,7 @@ var ci_default = new (0, _interactivecommander.Command)().command("ci").descript
   }
   const env = {
     LINGODOTDEV_API_KEY: settings.auth.apiKey,
-    LINGODOTDEV_PULL_REQUEST: _optionalChain([options, 'access', _300 => _300.pullRequest, 'optionalAccess', _301 => _301.toString, 'call', _302 => _302()]) || "false",
+    LINGODOTDEV_PULL_REQUEST: _optionalChain([options, 'access', _307 => _307.pullRequest, 'optionalAccess', _308 => _308.toString, 'call', _309 => _309()]) || "false",
     ...options.commitMessage && {
       LINGODOTDEV_COMMIT_MESSAGE: options.commitMessage
     },
@@ -9886,7 +10190,7 @@ var ci_default = new (0, _interactivecommander.Command)().command("ci").descript
   const { isPullRequestMode } = platformKit.config;
   ora.info(`Pull request mode: ${isPullRequestMode ? "on" : "off"}`);
   const flow = isPullRequestMode ? new PullRequestFlow(ora, platformKit) : new InBranchFlow(ora, platformKit);
-  const canRun = await _optionalChain([flow, 'access', _303 => _303.preRun, 'optionalCall', _304 => _304()]);
+  const canRun = await _optionalChain([flow, 'access', _310 => _310.preRun, 'optionalCall', _311 => _311()]);
   if (canRun === false) {
     return;
   }
@@ -9896,7 +10200,7 @@ var ci_default = new (0, _interactivecommander.Command)().command("ci").descript
   if (!hasChanges) {
     return;
   }
-  await _optionalChain([flow, 'access', _305 => _305.postRun, 'optionalCall', _306 => _306()]);
+  await _optionalChain([flow, 'access', _312 => _312.postRun, 'optionalCall', _313 => _313()]);
 });
 function parseBooleanArg(val) {
   if (val === true) return true;
@@ -9965,17 +10269,17 @@ var status_default = new (0, _interactivecommander.Command)().command("status").
       flags
     });
     let buckets = getBuckets(i18nConfig);
-    if (_optionalChain([flags, 'access', _307 => _307.bucket, 'optionalAccess', _308 => _308.length])) {
+    if (_optionalChain([flags, 'access', _314 => _314.bucket, 'optionalAccess', _315 => _315.length])) {
       buckets = buckets.filter(
         (bucket) => flags.bucket.includes(bucket.type)
       );
     }
     ora.succeed("Buckets retrieved");
-    if (_optionalChain([flags, 'access', _309 => _309.file, 'optionalAccess', _310 => _310.length])) {
+    if (_optionalChain([flags, 'access', _316 => _316.file, 'optionalAccess', _317 => _317.length])) {
       buckets = buckets.map((bucket) => {
         const paths = bucket.paths.filter(
           (path17) => flags.file.find(
-            (file) => _optionalChain([path17, 'access', _311 => _311.pathPattern, 'optionalAccess', _312 => _312.includes, 'call', _313 => _313(file)]) || _optionalChain([path17, 'access', _314 => _314.pathPattern, 'optionalAccess', _315 => _315.match, 'call', _316 => _316(file)]) || minimatch(path17.pathPattern, file)
+            (file) => _optionalChain([path17, 'access', _318 => _318.pathPattern, 'optionalAccess', _319 => _319.includes, 'call', _320 => _320(file)]) || _optionalChain([path17, 'access', _321 => _321.pathPattern, 'optionalAccess', _322 => _322.match, 'call', _323 => _323(file)]) || minimatch(path17.pathPattern, file)
           )
         );
         return { ...bucket, paths };
@@ -9995,7 +10299,7 @@ var status_default = new (0, _interactivecommander.Command)().command("status").
         });
       }
     }
-    const targetLocales = _optionalChain([flags, 'access', _317 => _317.locale, 'optionalAccess', _318 => _318.length]) ? flags.locale : i18nConfig.locale.targets;
+    const targetLocales = _optionalChain([flags, 'access', _324 => _324.locale, 'optionalAccess', _325 => _325.length]) ? flags.locale : i18nConfig.locale.targets;
     let totalSourceKeyCount = 0;
     let uniqueKeysToTranslate = 0;
     let totalExistingTranslations = 0;
@@ -10399,12 +10703,12 @@ function validateParams2(i18nConfig, flags) {
       message: "No buckets found in i18n.json. Please add at least one bucket containing i18n content.",
       docUrl: "bucketNotFound"
     });
-  } else if (_optionalChain([flags, 'access', _319 => _319.locale, 'optionalAccess', _320 => _320.some, 'call', _321 => _321((locale) => !i18nConfig.locale.targets.includes(locale))])) {
+  } else if (_optionalChain([flags, 'access', _326 => _326.locale, 'optionalAccess', _327 => _327.some, 'call', _328 => _328((locale) => !i18nConfig.locale.targets.includes(locale))])) {
     throw new CLIError({
       message: `One or more specified locales do not exist in i18n.json locale.targets. Please add them to the list and try again.`,
       docUrl: "localeTargetNotFound"
     });
-  } else if (_optionalChain([flags, 'access', _322 => _322.bucket, 'optionalAccess', _323 => _323.some, 'call', _324 => _324(
+  } else if (_optionalChain([flags, 'access', _329 => _329.bucket, 'optionalAccess', _330 => _330.some, 'call', _331 => _331(
     (bucket) => !i18nConfig.buckets[bucket]
   )])) {
     throw new CLIError({
@@ -10496,7 +10800,7 @@ async function renderHero2() {
 // package.json
 var package_default = {
   name: "lingo.dev",
-  version: "0.108.0",
+  version: "0.109.0",
   description: "Lingo.dev CLI",
   private: false,
   publishConfig: {
@@ -10660,6 +10964,7 @@ var package_default = {
     "is-url": "^1.2.4",
     jsdom: "^25.0.1",
     json5: "^2.2.3",
+    "jsonc-parser": "^3.3.1",
     jsonrepair: "^3.11.2",
     listr2: "^8.3.2",
     lodash: "^4.17.21",
@@ -10772,7 +11077,7 @@ var purge_default = new (0, _interactivecommander.Command)().command("purge").de
     if (options.file && options.file.length) {
       buckets = buckets.map((bucket) => {
         const paths = bucket.paths.filter(
-          (bucketPath) => _optionalChain([options, 'access', _325 => _325.file, 'optionalAccess', _326 => _326.some, 'call', _327 => _327((f) => bucketPath.pathPattern.includes(f))])
+          (bucketPath) => _optionalChain([options, 'access', _332 => _332.file, 'optionalAccess', _333 => _333.some, 'call', _334 => _334((f) => bucketPath.pathPattern.includes(f))])
         );
         return { ...bucket, paths };
       }).filter((bucket) => bucket.paths.length > 0);