@walkinissue/angy 0.2.17 → 0.2.19

package/dist/plugin.js

@@ -11,6 +11,30 @@ var CONFIG_FILENAMES = [
   "angy.config.mjs",
   "angy.config.cjs"
 ];
+var NON_REASONING_SUGGESTION_MODELS = [
+  "gpt-4.1",
+  "gpt-4.1-mini",
+  "gpt-4.1-nano"
+];
+var GPT54_REASONING_EFFORTS = ["none", "low", "medium", "high", "xhigh"];
+var GPT51_REASONING_EFFORTS = ["none", "low", "medium", "high"];
+var GPT5_REASONING_EFFORTS = ["minimal", "low", "medium", "high"];
+var GPT5_PRO_REASONING_EFFORTS = ["high"];
+var GPT5X_PRO_REASONING_EFFORTS = ["medium", "high", "xhigh"];
+var REASONING_EFFORTS_BY_MODEL = {
+  "gpt-5.4": GPT54_REASONING_EFFORTS,
+  "gpt-5.4-mini": GPT54_REASONING_EFFORTS,
+  "gpt-5.4-nano": GPT54_REASONING_EFFORTS,
+  "gpt-5.2": GPT54_REASONING_EFFORTS,
+  "gpt-5.1": GPT51_REASONING_EFFORTS,
+  "gpt-5": GPT5_REASONING_EFFORTS,
+  "gpt-5-pro": GPT5_PRO_REASONING_EFFORTS,
+  "gpt-5.2-pro": GPT5X_PRO_REASONING_EFFORTS,
+  "gpt-5.4-pro": GPT5X_PRO_REASONING_EFFORTS
+};
+var DEFAULT_SUGGESTION_MODEL = {
+  model: "gpt-4.1-mini"
+};
 function buildDefaultSystemMessage(sourceLocale, targetLocale) {
   return `You are an expert product localization assistant translating ${sourceLocale} UI copy into polished ${targetLocale}. Keep already-${targetLocale} text unchanged. Preserve placeholders like {0}, {1}, ICU fragments, HTML-like markers such as <0/> and <strong>, line breaks, punctuation, capitalization, and button-like brevity. Prefer terminology and syntax that stay close to the translated examples so the product voice remains cohesive. Do not invent extra context, do not expand abbreviations unless the examples already do, and avoid semantic drift. Return only high-confidence translation suggestions for the provided untranslated strings.`;
 }
@@ -37,6 +61,51 @@ function validateSuggestionProvider(suggestionProvider) {
     throw new Error(`[angy] suggestionProvider must be a function.`);
   }
 }
+function isNonReasoningSuggestionModel(model) {
+  return NON_REASONING_SUGGESTION_MODELS.includes(model);
+}
+function isSupportedSuggestionModel(model) {
+  return isNonReasoningSuggestionModel(model) || Object.prototype.hasOwnProperty.call(REASONING_EFFORTS_BY_MODEL, model);
+}
+function normalizeSuggestionModelConfig(input) {
+  const suggestionModel = input ?? DEFAULT_SUGGESTION_MODEL;
+  if (typeof suggestionModel !== "object" || suggestionModel == null || Array.isArray(suggestionModel)) {
+    throw new Error(
+      `[angy] suggestionModel must be an object like { model: "gpt-4.1-mini" }.`
+    );
+  }
+  if (typeof suggestionModel.model !== "string" || !suggestionModel.model.trim()) {
+    throw new Error(`[angy] suggestionModel.model is required and must be a non-empty string.`);
+  }
+  if (!isSupportedSuggestionModel(suggestionModel.model)) {
+    throw new Error(`[angy] Unsupported suggestionModel.model "${suggestionModel.model}".`);
+  }
+  if (isNonReasoningSuggestionModel(suggestionModel.model)) {
+    if (!("reasoning" in suggestionModel) || suggestionModel.reasoning === void 0 || suggestionModel.reasoning === null) {
+      return { model: suggestionModel.model, reasoning: null };
+    }
+    throw new Error(
+      `[angy] suggestionModel.reasoning is not supported for ${suggestionModel.model}.`
+    );
+  }
+  const allowedReasoning = REASONING_EFFORTS_BY_MODEL[suggestionModel.model];
+  const reasoning = suggestionModel.reasoning;
+  if (reasoning == null) {
+    if (suggestionModel.model === "gpt-5-pro") {
+      return { model: suggestionModel.model, reasoning: "high" };
+    }
+    return { model: suggestionModel.model };
+  }
+  if (!allowedReasoning.includes(reasoning)) {
+    throw new Error(
+      `[angy] suggestionModel.reasoning "${reasoning}" is not supported for ${suggestionModel.model}.`
+    );
+  }
+  return {
+    model: suggestionModel.model,
+    reasoning
+  };
+}
 var config = {
   basePoPath: resolve(__dirname, "../../locales/en.po"),
   workingPoPath: resolve(__dirname, "../../locales/en-working.po"),
@@ -45,7 +114,7 @@ var config = {
   routePath: "/api/translations",
   apiKey: "",
   systemMessage: buildDefaultSystemMessage("sv", "en"),
-  suggestionModel: "gpt-4.1-mini",
+  suggestionModel: DEFAULT_SUGGESTION_MODEL,
   watchIgnore: ["**/en-working.po"]
 };
 var loadedConfigRoot = null;
@@ -83,6 +152,21 @@ function validateLocaleAliasUsage(sourceLocale, targetLocale) {
     throw new Error('[angy] targetLocale cannot be "base". Use an explicit target locale or "working".');
   }
 }
+function validateCatalogPathSemantics(next) {
+  const baseLocale = inferLocaleFromCatalogPath(next.basePoPath);
+  const workingLocale = inferLocaleFromCatalogPath(next.workingPoPath);
+  const expectedWorkingLocale = `${next.targetLocale}-working`;
+  if (baseLocale !== next.targetLocale) {
+    throw new Error(
+      `[angy] basePoPath must point to the ${next.targetLocale}.po catalog. Received "${baseLocale ?? "unknown"}".`
+    );
+  }
+  if (workingLocale !== expectedWorkingLocale) {
+    throw new Error(
+      `[angy] workingPoPath must point to the ${expectedWorkingLocale}.po catalog. Received "${workingLocale ?? "unknown"}".`
+    );
+  }
+}
 function registerWorkingCatalogWatchController(controller) {
   workingCatalogWatchControllers.add(controller);
   return () => {
@@ -105,12 +189,14 @@ function resolveConfiguredLocaleAliases(next) {
   const resolvedSourceLocale = resolveLocaleAlias(rawSourceLocale, next);
   const resolvedTargetLocale = resolveLocaleAlias(rawTargetLocale, next);
   const usesDefaultSystemMessage = next.systemMessage === buildDefaultSystemMessage(rawSourceLocale, rawTargetLocale);
-  return {
+  const resolved = {
     ...next,
     sourceLocale: resolvedSourceLocale,
     targetLocale: resolvedTargetLocale,
     systemMessage: usesDefaultSystemMessage ? buildDefaultSystemMessage(resolvedSourceLocale, resolvedTargetLocale) : next.systemMessage
   };
+  validateCatalogPathSemantics(resolved);
+  return resolved;
 }
 function completeAngyConfig(input) {
   assertNonEmptyString(input.basePoPath, "basePoPath");
@@ -118,8 +204,8 @@ function completeAngyConfig(input) {
   assertNonEmptyString(input.sourceLocale, "sourceLocale");
   assertNonEmptyString(input.targetLocale, "targetLocale");
   validateLocaleAliasUsage(input.sourceLocale, input.targetLocale);
-  if (typeof input.apiKey !== "string") {
-    throw new Error(`[angy] apiKey is required and must be a string. Use an empty string to disable suggestions.`);
+  if (typeof input.apiKey !== "string" && typeof input.apiKey !== "undefined") {
+    throw new Error(`[angy] apiKey must be a string when provided. Use an empty string to disable suggestions.`);
   }
   validateRoutePath(input.routePath);
   validateWatchIgnore(input.watchIgnore);
@@ -130,15 +216,15 @@ function completeAngyConfig(input) {
     sourceLocale: input.sourceLocale,
     targetLocale: input.targetLocale,
     routePath: input.routePath ?? "/api/translations",
-    apiKey: input.apiKey,
+    apiKey: input.apiKey ?? "",
     systemMessage: input.systemMessage ?? buildDefaultSystemMessage(input.sourceLocale, input.targetLocale),
-    suggestionModel: input.suggestionModel ?? "gpt-4.1-mini",
+    suggestionModel: normalizeSuggestionModelConfig(input.suggestionModel),
     watchIgnore: input.watchIgnore ?? ["**/en-working.po"],
     suggestionProvider: input.suggestionProvider
   };
 }
 function defineAngyConfig(config2) {
-  return completeAngyConfig(config2);
+  return resolveConfiguredLocaleAliases(completeAngyConfig(config2));
 }
 async function fileExists(path) {
   try {
@@ -158,13 +244,19 @@ async function loadTsConfigModule(path) {
   const tempPath = `${path}.angy.tmp.mjs`;
   await writeFile(tempPath, transformed.code, "utf8");
   try {
-    return await import(`${pathToFileURL(tempPath).href}?t=${Date.now()}`);
+    return await import(
+      /* @vite-ignore */
+      `${pathToFileURL(tempPath).href}?t=${Date.now()}`
+    );
   } finally {
     await unlink(tempPath).catch(() => void 0);
   }
 }
 async function loadJsConfigModule(path) {
-  return import(pathToFileURL(path).href);
+  return import(
+    /* @vite-ignore */
+    pathToFileURL(path).href
+  );
 }
 async function loadAngyConfigFromRoot(root) {
   if (loadedConfigRoot === root) {
@@ -235,7 +327,7 @@ function angy(options = {}) {
       return {
         define: {
           __ANGY_ROUTE_PATH__: JSON.stringify(resolvedConfig.routePath ?? "/api/translations"),
-          __ANGY_LOCALES: JSON.stringify(localeRotation)
+          __ANGY_LOCALES__: JSON.stringify(localeRotation)
         },
         optimizeDeps: {
           exclude: ["angy", "angy/client", "angy/plugin", "angy/server"]

package/dist/server/types.ts

@@ -1,4 +1,5 @@
-export type TranslationOrigin = "base" | "working";
+export type TranslationOrigin = "base" | "working";
+export type TranslationStatus = "base" | "working" | "none" | "fuzzy" | "out_of_sync";
 
 export type CommitBatchItem = {
 	resolvedMsgid: string;
@@ -22,10 +23,10 @@ export type PoTranslationEntry = {
 	obsolete?: boolean;
 };
 
-export type NormalizedEntry = {
-	msgid: string;
-	msgctxt: string | null;
-	msgidPlural: string | null;
+export type NormalizedEntry = {
+	msgid: string;
+	msgctxt: string | null;
+	msgidPlural: string | null;
 	msgstr: string[];
 	references: string[];
 	extractedComments: string[];
@@ -35,6 +36,27 @@ export type NormalizedEntry = {
 	searchText: string;
 	searchTokens: string[];
 	hasTranslation: boolean;
-	isFuzzy: boolean | undefined;
-	translationOrigin: TranslationOrigin;
-};
+	isFuzzy: boolean | undefined;
+	translationOrigin: TranslationOrigin;
+};
+
+export type CatalogIntegrityIssue =
+	| {
+			type: "key_mismatch";
+			msgid: string;
+			msgctxt: string | null;
+			reason: "missing_in_working" | "missing_in_base";
+	  }
+	| {
+			type: "missing_working_translation";
+			msgid: string;
+			msgctxt: string | null;
+			baseValue: string;
+	  };
+
+export type RotationImpactItem = {
+	msgid: string;
+	msgctxt: string | null;
+	baseValue: string;
+	workingValue: string;
+};

package/dist/server.d.ts

@@ -56,8 +56,8 @@ export type SuggestionProviderInput = {
 	sourceLocale: string;
 	targetLocale: string;
 	systemMessage: string;
-	model: string;
-	apiKey: string;
+	suggestionModel: SuggestionModelConfig;
+	apiKey: string | undefined;
 };
 
 export type SuggestionProvider = (
@@ -70,13 +70,38 @@ export type AngyConfigInput = {
 	sourceLocale: string;
 	targetLocale: string;
 	routePath?: string;
-	apiKey: string;
+	apiKey?: string;
 	systemMessage?: string;
-	suggestionModel?: string;
+	suggestionModel?: SuggestionModelConfig;
 	watchIgnore?: string[];
 	suggestionProvider?: SuggestionProvider;
 };
 
+export type SuggestionModelConfig =
+	| { model: "gpt-4.1"; reasoning?: null }
+	| { model: "gpt-4.1-mini"; reasoning?: null }
+	| { model: "gpt-4.1-nano"; reasoning?: null }
+	| {
+			model: "gpt-5.4" | "gpt-5.4-mini" | "gpt-5.4-nano" | "gpt-5.2";
+			reasoning?: "none" | "low" | "medium" | "high" | "xhigh";
+	  }
+	| {
+			model: "gpt-5.1";
+			reasoning?: "none" | "low" | "medium" | "high";
+	  }
+	| {
+			model: "gpt-5";
+			reasoning?: "minimal" | "low" | "medium" | "high";
+	  }
+	| {
+			model: "gpt-5-pro";
+			reasoning?: "high";
+	  }
+	| {
+			model: "gpt-5.2-pro" | "gpt-5.4-pro";
+			reasoning?: "medium" | "high" | "xhigh";
+	  };
+
 export type AngyResolvedConfig = {
 	basePoPath: string;
 	workingPoPath: string;
@@ -85,7 +110,7 @@ export type AngyResolvedConfig = {
 	routePath: string;
 	apiKey: string;
 	systemMessage: string;
-	suggestionModel: string;
+	suggestionModel: SuggestionModelConfig;
 	watchIgnore: string[];
 	suggestionProvider?: SuggestionProvider;
 };