@fern-api/fern-api-dev 5.23.3-378-g4009024e80d → 5.23.3-382-g24ea8784553

package/cli.cjs

@@ -589242,7 +589242,7 @@ var GeneratorName = {
   STOPLIGHT: "fernapi/fern-stoplight",
   POSTMAN: "fernapi/fern-postman",
   OPENAPI_PYTHON_CLIENT: "fernapi/openapi-python-client",
-  CLI: "fernapi/fern-cli-generator"
+  CLI: "fernapi/fern-cli"
 };
 
 // ../configuration-loader/lib/generators-yml/addGenerator.js
@@ -669533,7 +669533,7 @@ var AccessTokenPosthogManager = class {
         properties: {
           ...event,
           ...event.properties,
-          version: "5.23.3-378-g4009024e80d",
+          version: "5.23.3-382-g24ea8784553",
           usingAccessToken: true,
           ...getRunIdProperties()
         }
@@ -669597,7 +669597,7 @@ var UserPosthogManager = class {
       distinctId: this.userId ?? await this.getPersistedDistinctId(),
       event: "CLI",
       properties: {
-        version: "5.23.3-378-g4009024e80d",
+        version: "5.23.3-382-g24ea8784553",
         ...event,
         ...event.properties,
         usingAccessToken: false,
@@ -675157,7 +675157,7 @@ var DOCKER_IMAGE_TO_GENERATOR_ID = {
   "fernapi/fern-swift-model": "swift-model",
   "fernapi/fern-postman": "postman",
   "fernapi/fern-openapi": "openapi",
-  "fernapi/fern-cli-generator": "cli"
+  "fernapi/fern-cli": "cli"
 };
 var DOCKER_IMAGE_TO_CHANGELOG_URL = {
   "fernapi/fern-typescript-sdk": "https://buildwithfern.com/learn/sdks/generators/typescript/changelog",
@@ -676976,7 +676976,7 @@ var MINIMUM_SUPPORTED_IR_VERSION = 53;
 
 // ../generation/ir-migrations/lib/generatorVersionMap.js
 var GENERATOR_MINIMUM_VERSIONS = {
-  "fernapi/fern-cli-generator": "0.0.1",
+  "fernapi/fern-cli": "0.0.1",
   "fernapi/fern-csharp-model": "0.0.2",
   "fernapi/fern-csharp-sdk": "0.5.0",
   "fernapi/fern-express": "0.17.3",
@@ -817800,6 +817800,106 @@ init_lib4();
 // ../docs-resolver/lib/index.js
 init_lib41();
 
+// ../docs-resolver/lib/applyTranslatedApiTitlesToNavTree.js
+init_lib4();
+init_js();
+function applyTranslatedApiTitlesToNavTree(root6, baseApis, translatedApis) {
+  const mapsByApiId = /* @__PURE__ */ new Map();
+  for (const [apiId, translatedApi] of Object.entries(translatedApis)) {
+    const holder = navigation_exports.ApiDefinitionHolder.create(translatedApi);
+    const endpoints = /* @__PURE__ */ new Map();
+    for (const [id2, endpoint3] of holder.endpoints) {
+      if (endpoint3.name != null && endpoint3.name.length > 0) {
+        endpoints.set(id2, endpoint3.name);
+      }
+    }
+    const webhooks2 = /* @__PURE__ */ new Map();
+    for (const [id2, webhook] of holder.webhooks) {
+      if (webhook.name != null && webhook.name.length > 0) {
+        webhooks2.set(id2, webhook.name);
+      }
+    }
+    const webSockets = /* @__PURE__ */ new Map();
+    for (const [id2, webSocket] of holder.webSockets) {
+      if (webSocket.name != null && webSocket.name.length > 0) {
+        webSockets.set(id2, webSocket.name);
+      }
+    }
+    const graphql4 = /* @__PURE__ */ new Map();
+    for (const [id2, operation] of holder.graphqlOperations) {
+      const name2 = operation.displayName ?? operation.name;
+      if (name2 != null && name2.length > 0) {
+        graphql4.set(id2, name2);
+      }
+    }
+    const packagesByBaseTitle = /* @__PURE__ */ new Map();
+    const baseApi = baseApis[apiId];
+    if (baseApi != null) {
+      for (const [subpackageId, translatedSubpackage] of Object.entries(translatedApi.subpackages)) {
+        const baseSubpackage = baseApi.subpackages[subpackageId];
+        if (baseSubpackage == null) {
+          continue;
+        }
+        const baseTitle = baseSubpackage.displayName ?? titleCase(baseSubpackage.name);
+        const translatedTitle = translatedSubpackage.displayName ?? titleCase(translatedSubpackage.name);
+        if (baseTitle !== translatedTitle) {
+          packagesByBaseTitle.set(baseTitle, translatedTitle);
+        }
+      }
+    }
+    mapsByApiId.set(apiId, { endpoints, webhooks: webhooks2, webSockets, graphql: graphql4, packagesByBaseTitle });
+  }
+  const clone5 = structuredClone(root6);
+  const visit5 = (node4) => {
+    if (node4 == null || typeof node4 !== "object") {
+      return;
+    }
+    if (Array.isArray(node4)) {
+      for (const item of node4) {
+        visit5(item);
+      }
+      return;
+    }
+    const obj = node4;
+    const apiDefinitionId = typeof obj.apiDefinitionId === "string" ? obj.apiDefinitionId : void 0;
+    const maps = apiDefinitionId != null ? mapsByApiId.get(apiDefinitionId) : void 0;
+    if (maps != null) {
+      const type8 = obj.type;
+      if (type8 === "endpoint" && typeof obj.endpointId === "string") {
+        const translated = maps.endpoints.get(obj.endpointId);
+        if (translated != null) {
+          obj.title = translated;
+        }
+      } else if (type8 === "webhook" && typeof obj.webhookId === "string") {
+        const translated = maps.webhooks.get(obj.webhookId);
+        if (translated != null) {
+          obj.title = translated;
+        }
+      } else if (type8 === "webSocket" && typeof obj.webSocketId === "string") {
+        const translated = maps.webSockets.get(obj.webSocketId);
+        if (translated != null) {
+          obj.title = translated;
+        }
+      } else if (type8 === "graphql" && typeof obj.graphqlOperationId === "string") {
+        const translated = maps.graphql.get(obj.graphqlOperationId);
+        if (translated != null) {
+          obj.title = translated;
+        }
+      } else if (type8 === "apiPackage" && typeof obj.title === "string") {
+        const translated = maps.packagesByBaseTitle.get(obj.title);
+        if (translated != null) {
+          obj.title = translated;
+        }
+      }
+    }
+    for (const value2 of Object.values(obj)) {
+      visit5(value2);
+    }
+  };
+  visit5(clone5);
+  return clone5;
+}
+
 // ../docs-resolver/lib/applyTranslatedFrontmatterToNavTree.js
 var import_gray_matter5 = __toESM(require_gray_matter(), 1);
 function parseFrontmatterOverrides(markdown) {
@@ -826340,7 +826440,8 @@ var DocsDefinitionResolver = class {
   uploadFiles;
   registerApi;
   targetAudiences;
-  constructor({ domain: domain3, docsWorkspace, ossWorkspaces, apiWorkspaces, taskContext, editThisPage, uploadFiles: uploadFiles2 = defaultUploadFiles, registerApi: registerApi2 = defaultRegisterApi, targetAudiences }) {
+  buildTranslatedApiDefinitions;
+  constructor({ domain: domain3, docsWorkspace, ossWorkspaces, apiWorkspaces, taskContext, editThisPage, uploadFiles: uploadFiles2 = defaultUploadFiles, registerApi: registerApi2 = defaultRegisterApi, targetAudiences, buildTranslatedApiDefinitions = false }) {
     this.domain = domain3;
     this.docsWorkspace = docsWorkspace;
     this.ossWorkspaces = ossWorkspaces;
@@ -826350,6 +826451,7 @@ var DocsDefinitionResolver = class {
     this.uploadFiles = uploadFiles2;
     this.registerApi = registerApi2;
     this.targetAudiences = targetAudiences;
+    this.buildTranslatedApiDefinitions = buildTranslatedApiDefinitions;
   }
   #idgen = NodeIdGenerator2.init();
   /**
@@ -826459,6 +826561,13 @@ var DocsDefinitionResolver = class {
   getDocsWorkspacePath() {
     return this.docsWorkspace.absoluteFilePath;
   }
+  /**
+   * Returns per-locale translated API definitions, keyed by locale then by the base
+   * `apiDefinitionId`. Must be called after `resolve()`.
+   */
+  getTranslatedApiSpecs() {
+    return this.translatedApiSpecs;
+  }
   getDocsTranslationsConfig() {
     const translations = this.parsedDocsConfig.translations;
     if (translations == null || translations.length === 0) {
@@ -826484,6 +826593,12 @@ var DocsDefinitionResolver = class {
   referencedMarkdownFiles = [];
   pendingApiRegistrations = [];
   pendingApiCounter = 0;
+  /**
+   * Per-locale translated API definitions, keyed by locale then by the base
+   * `apiDefinitionId`. Populated during {@link resolve} when an API section has
+   * a translated OpenAPI spec under `translations/<locale>/apis/<apiName>/`.
+   */
+  translatedApiSpecs = /* @__PURE__ */ new Map();
   async resolve() {
     const resolveStartTime = performance.now();
     const startMemory = process.memoryUsage();
@@ -826638,6 +826753,25 @@ var DocsDefinitionResolver = class {
           graphqlTypes: pending.graphqlTypes
         });
         updateApiDefinitionIdInTree(pending.apiReferenceNode, pending.tempApiDefinitionId, realApiDefinitionId);
+        if (pending.translatedIrsByLocale != null) {
+          for (const [locale, translatedIr] of pending.translatedIrsByLocale) {
+            this.resolveLinksInIrDocs(translatedIr, markdownFilesToPathName);
+            let localeMap = this.translatedApiSpecs.get(locale);
+            if (localeMap == null) {
+              localeMap = /* @__PURE__ */ new Map();
+              this.translatedApiSpecs.set(locale, localeMap);
+            }
+            localeMap.set(realApiDefinitionId, {
+              ir: translatedIr,
+              snippetsConfig: pending.snippetsConfig,
+              playgroundConfig: pending.playgroundConfig,
+              apiName: pending.apiName,
+              graphqlOperations: pending.graphqlOperations,
+              graphqlTypes: pending.graphqlTypes,
+              workspace: pending.workspace
+            });
+          }
+        }
       }
       const deferredTime = performance.now() - deferredStart;
       this.taskContext.logger.debug(`Processed deferred API registrations in ${deferredTime.toFixed(0)}ms`);
@@ -826996,6 +827130,112 @@ Learn more about project structure:
 https://buildwithfern.com/learn/docs/getting-started/project-structure#api-definitions` : "Failed to load API Definition referenced in docs.\nLearn more about project structure:\nhttps://buildwithfern.com/learn/docs/getting-started/project-structure#api-definitions";
     throw new CliError({ message: errorMessage, code: CliError.Code.ConfigError });
   }
+  /**
+   * Builds a translated IR for each configured non-default locale whose
+   * `translations/<locale>/apis/<apiName>/` directory contains a translated copy of
+   * the API's OpenAPI spec. The translated spec must be structurally identical to the
+   * base (same paths, operationIds, schema names) so the derived IR lines up 1:1 and
+   * can be keyed by the same `apiDefinitionId`.
+   */
+  async buildTranslatedApiIrs(item, baseOssWorkspace) {
+    const translationsConfig = this.getDocsTranslationsConfig();
+    if (translationsConfig?.translations == null || translationsConfig.translations.length === 0) {
+      return void 0;
+    }
+    const { defaultLocale, translations } = translationsConfig;
+    const fernFolder = this.docsWorkspace.absoluteFilePath;
+    const result = /* @__PURE__ */ new Map();
+    for (const locale of translations) {
+      if (locale === defaultLocale) {
+        continue;
+      }
+      const translatedWorkspace = this.createTranslatedOssWorkspace(baseOssWorkspace, locale, fernFolder);
+      if (translatedWorkspace == null) {
+        continue;
+      }
+      try {
+        const translatedIr = await translatedWorkspace.getIntermediateRepresentation({
+          context: this.taskContext,
+          audiences: item.audiences,
+          enableUniqueErrorsPerEndpoint: true,
+          generateV1Examples: false,
+          logWarnings: false
+        });
+        result.set(locale, translatedIr);
+        this.taskContext.logger.debug(`Built translated API definition for locale "${locale}" (api: ${item.apiName ?? baseOssWorkspace.workspaceName ?? "<default>"})`);
+      } catch (error50) {
+        this.taskContext.logger.warn(`Failed to build translated API definition for locale "${locale}": ${extractErrorMessage(error50)}. Falling back to the default-locale API for this locale.`);
+      }
+    }
+    return result.size > 0 ? result : void 0;
+  }
+  /**
+   * Clones an OSS (OpenAPI) workspace, remapping spec file paths from `apis/<...>` to
+   * `translations/<locale>/apis/<...>` wherever a translated file exists. Returns
+   * `undefined` when no primary spec has a translated counterpart. Override/overlay
+   * files fall back to the base copy when untranslated, keeping structural metadata
+   * (x-fern-* extensions, audiences, etc.) consistent with the base definition.
+   */
+  createTranslatedOssWorkspace(base4, locale, fernFolder) {
+    let hasTranslatedSpec = false;
+    const toTranslatedPath = (absPath, countsAsTranslation) => {
+      const rel2 = relative4(fernFolder, absPath);
+      if (String(rel2).startsWith("..")) {
+        return absPath;
+      }
+      const candidate = join8(fernFolder, RelativeFilePath2.of(`translations/${locale}`), rel2);
+      if ((0, import_fs26.existsSync)(candidate)) {
+        if (countsAsTranslation) {
+          hasTranslatedSpec = true;
+        }
+        return candidate;
+      }
+      return absPath;
+    };
+    const remapOverrides = (overrides) => {
+      if (overrides == null) {
+        return overrides;
+      }
+      if (Array.isArray(overrides)) {
+        return overrides.map((p14) => toTranslatedPath(p14, false));
+      }
+      return toTranslatedPath(overrides, false);
+    };
+    const remapSpec = (spec) => {
+      switch (spec.type) {
+        case "openapi":
+          return {
+            ...spec,
+            absoluteFilepath: toTranslatedPath(spec.absoluteFilepath, true),
+            absoluteFilepathToOverrides: remapOverrides(spec.absoluteFilepathToOverrides),
+            absoluteFilepathToOverlays: spec.absoluteFilepathToOverlays != null ? toTranslatedPath(spec.absoluteFilepathToOverlays, false) : void 0
+          };
+        case "openrpc":
+        case "graphql":
+          return {
+            ...spec,
+            absoluteFilepath: toTranslatedPath(spec.absoluteFilepath, true),
+            absoluteFilepathToOverrides: remapOverrides(spec.absoluteFilepathToOverrides)
+          };
+        default:
+          return spec;
+      }
+    };
+    const translatedSpecs = base4.specs.map((spec) => remapSpec(spec));
+    const translatedAllSpecs = base4.allSpecs.map((spec) => remapSpec(spec));
+    if (!hasTranslatedSpec) {
+      return void 0;
+    }
+    return new OSSWorkspace({
+      allSpecs: translatedAllSpecs,
+      specs: translatedSpecs,
+      generatorsConfiguration: base4.generatorsConfiguration,
+      workspaceName: base4.workspaceName,
+      cliVersion: base4.cliVersion,
+      absoluteFilePath: base4.absoluteFilePath,
+      changelog: base4.changelog
+    });
+  }
   async toRootNode() {
     const slug = navigation_exports.V1.SlugGenerator.init(navigation_exports.slugjoin(this.getDocsBasePath()));
     const id2 = this.#idgen.get("root");
@@ -827414,6 +827654,10 @@ https://buildwithfern.com/learn/docs/getting-started/project-structure#api-defin
       this.parsedDocsConfig.pages[relativePath] = processedContent;
     }
     const apiReferenceNode = node4.get();
+    let translatedIrsByLocale;
+    if (this.buildTranslatedApiDefinitions && openapiWorkspace != null) {
+      translatedIrsByLocale = await this.buildTranslatedApiIrs(item, openapiWorkspace);
+    }
     this.pendingApiRegistrations.push({
       ir: ir11,
       snippetsConfig,
@@ -827423,7 +827667,8 @@ https://buildwithfern.com/learn/docs/getting-started/project-structure#api-defin
       graphqlOperations: graphqlData.operations,
       graphqlTypes: graphqlData.types,
       tempApiDefinitionId,
-      apiReferenceNode
+      apiReferenceNode,
+      translatedIrsByLocale
     });
     return apiReferenceNode;
   }
@@ -861038,7 +861283,7 @@ var LOCAL_STORAGE_FOLDER4 = ".fern-dev";
 var LOGS_FOLDER_NAME = "logs";
 var MAX_LOGS_DIR_SIZE_BYTES = 100 * 1024 * 1024;
 function getCliSource() {
-  const version7 = "5.23.3-378-g4009024e80d";
+  const version7 = "5.23.3-382-g24ea8784553";
   return `cli@${version7}`;
 }
 var DebugLogger = class {
@@ -863879,7 +864124,8 @@ async function getPreviewDocsDefinition({ domain: domain3, project, context: con
         translationPages: previousPreviewResult.translationPages,
         translationNavigationOverlays: previousPreviewResult.translationNavigationOverlays,
         collectedFileIds: previousPreviewResult.collectedFileIds,
-        docsWorkspacePath: previousPreviewResult.docsWorkspacePath
+        docsWorkspacePath: previousPreviewResult.docsWorkspacePath,
+        translatedApiDefinitions: previousPreviewResult.translatedApiDefinitions
       };
     }
   }
@@ -863908,7 +864154,8 @@ async function getPreviewDocsDefinition({ domain: domain3, project, context: con
       };
     }),
     registerApi: async (opts) => apiCollector.addReferencedAPI(opts),
-    targetAudiences: void 0
+    targetAudiences: void 0,
+    buildTranslatedApiDefinitions: true
   });
   const writeDocsDefinition = await resolver2.resolve();
   const dbDocsDefinition = convertDocsDefinitionToDb({
@@ -863951,14 +864198,54 @@ async function getPreviewDocsDefinition({ domain: domain3, project, context: con
   const translationPages = resolver2.getTranslationPages();
   const translationNavigationOverlays = resolver2.getTranslationNavigationOverlays();
   const collectedFileIds = resolver2.getCollectedFileIds();
+  const translatedApiSpecs = resolver2.getTranslatedApiSpecs();
+  let translatedApiDefinitions;
+  if (translatedApiSpecs.size > 0) {
+    translatedApiDefinitions = {};
+    for (const [locale, byApiId] of translatedApiSpecs) {
+      const localeApis = {};
+      for (const [apiDefinitionId, spec] of byApiId) {
+        try {
+          localeApis[apiDefinitionId] = convertTranslatedIrToReadApi(spec, apiDefinitionId, context3);
+        } catch (error50) {
+          context3.logger.warn(`Failed to convert translated API definition "${apiDefinitionId}" for locale "${locale}": ${extractErrorMessage(error50)}. Falling back to the default-locale API.`);
+        }
+      }
+      if (Object.keys(localeApis).length > 0) {
+        translatedApiDefinitions[locale] = localeApis;
+      }
+    }
+    if (Object.keys(translatedApiDefinitions).length === 0) {
+      translatedApiDefinitions = void 0;
+    }
+  }
   return {
     docsDefinition,
     translationPages,
     translationNavigationOverlays,
     collectedFileIds,
-    docsWorkspacePath: docsWorkspace.absoluteFilePath
+    docsWorkspacePath: docsWorkspace.absoluteFilePath,
+    translatedApiDefinitions
   };
 }
+function convertTranslatedIrToReadApi(spec, apiDefinitionId, context3) {
+  const dbApiDefinition = convertAPIDefinitionToDb(convertIrToFdrApi({
+    ir: spec.ir,
+    snippetsConfig: spec.snippetsConfig,
+    playgroundConfig: spec.playgroundConfig,
+    graphqlOperations: spec.graphqlOperations ?? {},
+    graphqlTypes: spec.graphqlTypes ?? {},
+    context: context3,
+    apiNameOverride: spec.apiName
+  }), FdrAPI_exports.ApiDefinitionId(apiDefinitionId), new SDKSnippetHolder({
+    snippetsConfigWithSdkId: {},
+    snippetsBySdkId: {},
+    snippetTemplatesByEndpoint: {},
+    snippetTemplatesByEndpointId: {},
+    snippetsBySdkIdAndEndpointId: {}
+  }));
+  return convertDbAPIDefinitionToRead(dbApiDefinition);
+}
 async function applyGlobalThemeIfNeeded(docsWorkspace, organization, context3) {
   const themeName = docsWorkspace.config.globalTheme;
   if (themeName == null) {
@@ -864546,15 +864833,22 @@ async function runAppPreviewServer({ initialProject, reloadProject, validateProj
   const RELOAD_DEBOUNCE_MS = 1e3;
   async function computeTranslatedDefinitions(result) {
     const translations = /* @__PURE__ */ new Map();
-    const { docsDefinition, translationPages, translationNavigationOverlays, collectedFileIds, docsWorkspacePath } = result;
-    if (translationPages == null || Object.keys(translationPages).length === 0) {
+    const { docsDefinition, translationPages, translationNavigationOverlays, translatedApiDefinitions, collectedFileIds, docsWorkspacePath } = result;
+    const hasTranslatedPages = translationPages != null && Object.keys(translationPages).length > 0;
+    const hasTranslatedApis = translatedApiDefinitions != null && Object.keys(translatedApiDefinitions).length > 0;
+    if (!hasTranslatedPages && !hasTranslatedApis) {
       return translations;
     }
     const defaultLocale = docsDefinition.config.translations?.defaultLocale;
-    for (const [locale, localePages] of Object.entries(translationPages)) {
+    const localesToBuild = /* @__PURE__ */ new Set([
+      ...Object.keys(translationPages ?? {}),
+      ...Object.keys(translatedApiDefinitions ?? {})
+    ]);
+    for (const locale of localesToBuild) {
       if (locale === defaultLocale) {
         continue;
       }
+      const localePages = translationPages?.[locale] ?? {};
       try {
         const resolveLocalePath = async (filepath) => {
           const relPath = relative4(docsWorkspacePath, filepath);
@@ -864633,8 +864927,14 @@ async function runAppPreviewServer({ initialProject, reloadProject, validateProj
             translatedNavbarLinks = localeNavOverlay.navbarLinks;
           }
         }
+        const localeApis = translatedApiDefinitions?.[locale];
+        const translatedApis = localeApis != null ? { ...docsDefinition.apis, ...localeApis } : docsDefinition.apis;
+        if (localeApis != null && updatedRoot != null) {
+          updatedRoot = applyTranslatedApiTitlesToNavTree(updatedRoot, docsDefinition.apis, localeApis);
+        }
         const translatedDefinition = {
           ...docsDefinition,
+          apis: translatedApis,
           pages: translatedPages,
           config: {
             ...docsDefinition.config,
@@ -864644,7 +864944,7 @@ async function runAppPreviewServer({ initialProject, reloadProject, validateProj
           }
         };
         translations.set(locale, translatedDefinition);
-        context3.logger.debug(`Computed translated definition for locale "${locale}"`);
+        context3.logger.debug(`Computed translated definition for locale "${locale}"` + (localeApis != null ? ` (with ${Object.keys(localeApis).length} translated API(s))` : ""));
       } catch (error50) {
         context3.logger.warn(`Failed to compute translation for locale "${locale}": ${String(error50)}`);
       }
@@ -890934,6 +891234,114 @@ async function publishDocs({ token, organization, docsWorkspace, domain: domain3
       token: token.value,
       taskContext: context3
     });
+    const buildTranslatedApiDefinitions = docsWorkspace.config.translations != null && docsWorkspace.config.translations.length > 1;
+    const readApiDefinitionsById = /* @__PURE__ */ new Map();
+    const captureReadApiDefinition = (definition3, apiDefinitionId) => {
+      if (!buildTranslatedApiDefinitions) {
+        return;
+      }
+      try {
+        const dbApiDefinition = convertAPIDefinitionToDb(definition3, FdrAPI_exports.ApiDefinitionId(apiDefinitionId), new SDKSnippetHolder({
+          snippetsConfigWithSdkId: {},
+          snippetsBySdkId: {},
+          snippetTemplatesByEndpoint: {},
+          snippetTemplatesByEndpointId: {},
+          snippetsBySdkIdAndEndpointId: {}
+        }));
+        readApiDefinitionsById.set(apiDefinitionId, convertDbAPIDefinitionToRead(dbApiDefinition));
+      } catch (error50) {
+        context3.logger.debug(`Failed to build read API definition for ${apiDefinitionId} (translated sidebar titles may stay in the default language): ${String(error50)}`);
+      }
+    };
+    const registerApiToFdr = async ({ ir: ir11, snippetsConfig, playgroundConfig, apiName, workspace, graphqlOperations, graphqlTypes }) => {
+      let apiDefinition = convertIrToFdrApi({
+        ir: ir11,
+        snippetsConfig,
+        playgroundConfig,
+        graphqlOperations,
+        graphqlTypes,
+        context: context3,
+        apiNameOverride: apiName
+      });
+      const isSelfHosted = token.value === "dummy";
+      const aiEnhancerConfig = getAIEnhancerConfig(withAiExamples && !isSelfHosted, docsWorkspace.config.aiExamples?.style ?? docsWorkspace.config.experimental?.aiExampleStyleInstructions);
+      if (aiEnhancerConfig) {
+        const sources = workspace?.getSources();
+        const openApiSources = sources?.filter((source2) => source2.type === "openapi").map((source2) => ({
+          absoluteFilePath: source2.absoluteFilePath,
+          absoluteFilePathToOverrides: source2.absoluteFilePathToOverrides
+        }));
+        if (openApiSources == null || openApiSources.length === 0) {
+          context3.logger.debug("Skipping AI example enhancement: no OpenAPI source file paths available");
+        } else {
+          apiDefinition = await enhanceExamplesWithAI(apiDefinition, aiEnhancerConfig, context3, token, organization, openApiSources);
+        }
+      }
+      let dynamicIRsByLanguage;
+      let languagesWithExistingSdkDynamicIr = /* @__PURE__ */ new Set();
+      if (Object.keys(snippetsConfig).length === 0) {
+        context3.logger.debug(`No snippets configuration defined, skipping snippet generation...`);
+      } else if (!disableDynamicSnippets) {
+        const existingSdkDynamicIrs = await checkAndDownloadExistingSdkDynamicIRs({
+          fdr,
+          workspace,
+          organization,
+          context: context3,
+          snippetsConfig
+        });
+        if (existingSdkDynamicIrs && Object.keys(existingSdkDynamicIrs).length > 0) {
+          dynamicIRsByLanguage = existingSdkDynamicIrs;
+          languagesWithExistingSdkDynamicIr = new Set(Object.keys(existingSdkDynamicIrs));
+          context3.logger.debug(`Using existing SDK dynamic IRs for: ${Object.keys(existingSdkDynamicIrs).join(", ")}`);
+        }
+        const generatedDynamicIRs = await generateLanguageSpecificDynamicIRs({
+          workspace,
+          organization,
+          context: context3,
+          snippetsConfig,
+          skipLanguages: languagesWithExistingSdkDynamicIr
+        });
+        if (generatedDynamicIRs) {
+          dynamicIRsByLanguage = {
+            ...dynamicIRsByLanguage,
+            ...generatedDynamicIRs
+          };
+        }
+      }
+      let response;
+      try {
+        response = await fdr.api.register.registerApiDefinition({
+          orgId: FdrAPI_exports.OrgId(organization),
+          apiId: FdrAPI_exports.ApiId(apiName ?? getOriginalName(ir11.apiName)),
+          definition: apiDefinition,
+          dynamicIRs: dynamicIRsByLanguage
+        });
+      } catch (error50) {
+        const errorDetails = extractErrorDetails(error50);
+        context3.logger.error(`FDR registerApiDefinition failed. Error details:
+${JSON.stringify(errorDetails, void 0, 2)}`);
+        if (apiName != null) {
+          return context3.failAndThrow(`Failed to publish docs because API definition (${apiName}) could not be uploaded. Please contact support@buildwithfern.com`, errorDetails, { code: CliError.Code.NetworkError });
+        } else {
+          return context3.failAndThrow(`Failed to publish docs because API definition could not be uploaded. Please contact support@buildwithfern.com`, errorDetails, { code: CliError.Code.NetworkError });
+        }
+      }
+      context3.logger.debug(`Registered API Definition ${apiName}: ${response.apiDefinitionId}`);
+      if (response.dynamicIRs && dynamicIRsByLanguage) {
+        if (skipUpload) {
+          context3.logger.debug("Skip-upload mode: skipping dynamic IR uploads");
+        } else {
+          await uploadDynamicIRs({
+            dynamicIRs: dynamicIRsByLanguage,
+            dynamicIRUploadUrls: response.dynamicIRs,
+            context: context3,
+            apiId: response.apiDefinitionId
+          });
+        }
+      }
+      captureReadApiDefinition(apiDefinition, response.apiDefinitionId);
+      return response.apiDefinitionId;
+    };
     const resolver2 = new DocsDefinitionResolver({
       domain: domain3,
       docsWorkspace: effectiveWorkspace,
@@ -891057,94 +891465,8 @@ async function publishDocs({ token, organization, docsWorkspace, domain: domain3
           return convertToFilePathPairs(startDocsRegisterResponse.uploadUrls, docsWorkspace.absoluteFilePath, sanitizedToAbsoluteMap);
         }
       },
-      registerApi: async ({ ir: ir11, snippetsConfig, playgroundConfig, apiName, workspace, graphqlOperations, graphqlTypes }) => {
-        let apiDefinition = convertIrToFdrApi({
-          ir: ir11,
-          snippetsConfig,
-          playgroundConfig,
-          graphqlOperations,
-          graphqlTypes,
-          context: context3,
-          apiNameOverride: apiName
-        });
-        const isSelfHosted = token.value === "dummy";
-        const aiEnhancerConfig = getAIEnhancerConfig(withAiExamples && !isSelfHosted, docsWorkspace.config.aiExamples?.style ?? docsWorkspace.config.experimental?.aiExampleStyleInstructions);
-        if (aiEnhancerConfig) {
-          const sources = workspace?.getSources();
-          const openApiSources = sources?.filter((source2) => source2.type === "openapi").map((source2) => ({
-            absoluteFilePath: source2.absoluteFilePath,
-            absoluteFilePathToOverrides: source2.absoluteFilePathToOverrides
-          }));
-          if (openApiSources == null || openApiSources.length === 0) {
-            context3.logger.debug("Skipping AI example enhancement: no OpenAPI source file paths available");
-          } else {
-            apiDefinition = await enhanceExamplesWithAI(apiDefinition, aiEnhancerConfig, context3, token, organization, openApiSources);
-          }
-        }
-        let dynamicIRsByLanguage;
-        let languagesWithExistingSdkDynamicIr = /* @__PURE__ */ new Set();
-        if (Object.keys(snippetsConfig).length === 0) {
-          context3.logger.debug(`No snippets configuration defined, skipping snippet generation...`);
-        } else if (!disableDynamicSnippets) {
-          const existingSdkDynamicIrs = await checkAndDownloadExistingSdkDynamicIRs({
-            fdr,
-            workspace,
-            organization,
-            context: context3,
-            snippetsConfig
-          });
-          if (existingSdkDynamicIrs && Object.keys(existingSdkDynamicIrs).length > 0) {
-            dynamicIRsByLanguage = existingSdkDynamicIrs;
-            languagesWithExistingSdkDynamicIr = new Set(Object.keys(existingSdkDynamicIrs));
-            context3.logger.debug(`Using existing SDK dynamic IRs for: ${Object.keys(existingSdkDynamicIrs).join(", ")}`);
-          }
-          const generatedDynamicIRs = await generateLanguageSpecificDynamicIRs({
-            workspace,
-            organization,
-            context: context3,
-            snippetsConfig,
-            skipLanguages: languagesWithExistingSdkDynamicIr
-          });
-          if (generatedDynamicIRs) {
-            dynamicIRsByLanguage = {
-              ...dynamicIRsByLanguage,
-              ...generatedDynamicIRs
-            };
-          }
-        }
-        let response;
-        try {
-          response = await fdr.api.register.registerApiDefinition({
-            orgId: FdrAPI_exports.OrgId(organization),
-            apiId: FdrAPI_exports.ApiId(apiName ?? getOriginalName(ir11.apiName)),
-            definition: apiDefinition,
-            dynamicIRs: dynamicIRsByLanguage
-          });
-        } catch (error50) {
-          const errorDetails = extractErrorDetails(error50);
-          context3.logger.error(`FDR registerApiDefinition failed. Error details:
-${JSON.stringify(errorDetails, void 0, 2)}`);
-          if (apiName != null) {
-            return context3.failAndThrow(`Failed to publish docs because API definition (${apiName}) could not be uploaded. Please contact support@buildwithfern.com`, errorDetails, { code: CliError.Code.NetworkError });
-          } else {
-            return context3.failAndThrow(`Failed to publish docs because API definition could not be uploaded. Please contact support@buildwithfern.com`, errorDetails, { code: CliError.Code.NetworkError });
-          }
-        }
-        context3.logger.debug(`Registered API Definition ${apiName}: ${response.apiDefinitionId}`);
-        if (response.dynamicIRs && dynamicIRsByLanguage) {
-          if (skipUpload) {
-            context3.logger.debug("Skip-upload mode: skipping dynamic IR uploads");
-          } else {
-            await uploadDynamicIRs({
-              dynamicIRs: dynamicIRsByLanguage,
-              dynamicIRUploadUrls: response.dynamicIRs,
-              context: context3,
-              apiId: response.apiDefinitionId
-            });
-          }
-        }
-        return response.apiDefinitionId;
-      },
+      registerApi: registerApiToFdr,
+      buildTranslatedApiDefinitions,
       targetAudiences
     });
     context3.logger.info("Resolving docs definition...");
@@ -891184,6 +891506,27 @@ ${JSON.stringify(errorDetails, void 0, 2)}`);
     }
     const publishTime = performance.now() - publishStart;
     context3.logger.debug(`Docs published to FDR in ${publishTime.toFixed(0)}ms`);
+    const translatedApiSpecsByLocale = buildTranslatedApiDefinitions ? resolver2.getTranslatedApiSpecs() : /* @__PURE__ */ new Map();
+    const translatedApiIdsByLocale = /* @__PURE__ */ new Map();
+    if (translatedApiSpecsByLocale.size > 0) {
+      context3.logger.info(`Registering translated API definitions for ${translatedApiSpecsByLocale.size} locale(s)...`);
+      for (const [locale, specsByBaseApiId] of translatedApiSpecsByLocale) {
+        const idMap = /* @__PURE__ */ new Map();
+        for (const [baseApiId, spec] of specsByBaseApiId) {
+          try {
+            const translatedApiId = await registerApiToFdr(spec);
+            if (translatedApiId !== baseApiId) {
+              idMap.set(baseApiId, translatedApiId);
+            }
+          } catch (error50) {
+            context3.logger.warn(`Failed to register translated API definition for locale "${locale}" (API reference will render in the default language): ${String(error50)}`);
+          }
+        }
+        if (idMap.size > 0) {
+          translatedApiIdsByLocale.set(locale, idMap);
+        }
+      }
+    }
     const translationPages = resolver2.getTranslationPages();
     const translationNavigationOverlays = resolver2.getTranslationNavigationOverlays();
     const translationDomain = preview ? urlToOutput : domain3;
@@ -891283,6 +891626,25 @@ ${JSON.stringify(errorDetails, void 0, 2)}`);
               translatedNavbarLinks = localeNavOverlay.navbarLinks;
             }
           }
+          const localeApiIdMap = translatedApiIdsByLocale.get(locale);
+          if (localeApiIdMap != null && localeApiIdMap.size > 0 && updatedRoot != null) {
+            const baseApisForTitles = {};
+            const translatedApisForTitles = {};
+            for (const [baseApiId, translatedApiId] of localeApiIdMap) {
+              const baseRead = readApiDefinitionsById.get(baseApiId);
+              const translatedRead = readApiDefinitionsById.get(translatedApiId);
+              if (baseRead != null) {
+                baseApisForTitles[baseApiId] = baseRead;
+              }
+              if (translatedRead != null) {
+                translatedApisForTitles[baseApiId] = translatedRead;
+              }
+            }
+            updatedRoot = Object.keys(translatedApisForTitles).length > 0 ? applyTranslatedApiTitlesToNavTree(updatedRoot, baseApisForTitles, translatedApisForTitles) : structuredClone(updatedRoot);
+            for (const [baseApiId, translatedApiId] of localeApiIdMap) {
+              updateApiDefinitionIdInTree(updatedRoot, baseApiId, translatedApiId);
+            }
+          }
           const translatedDefinition = {
             ...docsDefinition,
             pages: translatedPages,
@@ -892013,7 +892375,7 @@ var LegacyDocsPublisher = class {
         previewId,
         disableTemplates: void 0,
         skipUpload,
-        cliVersion: "5.23.3-378-g4009024e80d",
+        cliVersion: "5.23.3-382-g24ea8784553",
         loginCommand: "fern auth login"
       });
       if (taskContext.getResult() === TaskResult.Failure) {
@@ -895618,7 +895980,7 @@ var CONTAINER_SOURCES_DIRECTORY = DOCKER_SOURCES_DIRECTORY;
 var DOCKER_SPECS_DIRECTORY = import_path84.default.join(DOCKER_FERN_DIRECTORY, SPECS_DIRECTORY_NAME);
 var CONTAINER_SPECS_DIRECTORY = DOCKER_SPECS_DIRECTORY;
 var DEFAULT_NODE_DEBUG_PORT = "9229";
-var GENERATORS_WANTING_SPECS = /* @__PURE__ */ new Set(["fernapi/fern-cli-generator"]);
+var GENERATORS_WANTING_SPECS = /* @__PURE__ */ new Set(["fernapi/fern-cli"]);
 function generatorWantsSpecs(generatorName) {
   return GENERATORS_WANTING_SPECS.has(generatorName);
 }
@@ -957100,7 +957462,7 @@ function getAutomationContextFromEnv() {
     config_branch: process.env.FERN_CONFIG_BRANCH,
     config_pr_number: process.env.FERN_CONFIG_PR_NUMBER,
     trigger: process.env.GITHUB_EVENT_NAME,
-    cli_version: "5.23.3-378-g4009024e80d"
+    cli_version: "5.23.3-382-g24ea8784553"
   };
 }
 function isAutomationMode() {
@@ -957926,7 +958288,7 @@ var CliContext = class _CliContext {
     if (false) {
       this.logger.error("CLI_VERSION is not defined");
     }
-    return "5.23.3-378-g4009024e80d";
+    return "5.23.3-382-g24ea8784553";
   }
   getCliName() {
     if (false) {

package/package.json

@@ -1,5 +1,5 @@
 {
-  "version": "5.23.3-378-g4009024e80d",
+  "version": "5.23.3-382-g24ea8784553",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/fern-api/fern.git",