@walkinissue/angy 0.2.17 → 0.2.18

package/dist/plugin.js

@@ -83,6 +83,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 +120,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 +135,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,7 +147,7 @@ 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",
     watchIgnore: input.watchIgnore ?? ["**/en-working.po"],
@@ -138,7 +155,7 @@ function completeAngyConfig(input) {
   };
 }
 function defineAngyConfig(config2) {
-  return completeAngyConfig(config2);
+  return resolveConfiguredLocaleAliases(completeAngyConfig(config2));
 }
 async function fileExists(path) {
   try {
@@ -158,13 +175,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 +258,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

@@ -57,7 +57,7 @@ export type SuggestionProviderInput = {
 	targetLocale: string;
 	systemMessage: string;
 	model: string;
-	apiKey: string;
+	apiKey: string | undefined;
 };
 
 export type SuggestionProvider = (
@@ -70,7 +70,7 @@ export type AngyConfigInput = {
 	sourceLocale: string;
 	targetLocale: string;
 	routePath?: string;
-	apiKey: string;
+	apiKey?: string;
 	systemMessage?: string;
 	suggestionModel?: string;
 	watchIgnore?: string[];