@intlayer/docs 9.1.3 → 9.3.0

package/src/generated/frequentQuestions.entry.ts

@@ -32,7 +32,10 @@ try {
   }
 }
 
-const readLocale = (
+/**
+ * Reads a document, preferring the requested locale and falling back to English.
+ */
+const readLocaleFile = async (
   relativeAfterLocale: string,
   locale: LocalesValues
 ): Promise<string> => {
@@ -41,32 +44,61 @@ const readLocale = (
     `./frequent_questions/${locale}/${relativeAfterLocale}`
   );
   if (existsSync(target1)) {
-    return readFile(target1, 'utf8');
+    return await readFile(target1, 'utf8');
   }
   const target2 = join(
     baseDir,
     `./frequent_questions/en/${relativeAfterLocale}`
   );
   if (existsSync(target2)) {
-    return readFile(target2, 'utf8');
+    return await readFile(target2, 'utf8');
   }
 
-  return Promise.reject(
-    new Error(
-      `[docs] File not found: ${relativeAfterLocale} - locale: ${locale} - path: ${target1} - path: ${target2}`
-    )
+  throw new Error(
+    `[docs] File not found: ${relativeAfterLocale} - locale: ${locale} - path: ${target1} - path: ${target2}`
   );
 };
 
+/**
+ * Builds a lazy, awaitable handle over a document.
+ *
+ * The entry map below holds one handle per document *per locale*, so reading
+ * eagerly would pull every markdown file of every locale into memory as soon as
+ * this module is imported — hundreds of megabytes, duplicated in every
+ * prerender worker, for the handful of documents a page actually renders.
+ *
+ * The returned value is a thenable rather than a promise: consumers only ever
+ * `await` it, and `await` triggers `then`, so the file is read on first use and
+ * the resulting promise is cached for subsequent reads.
+ */
+const readLocale = (
+  relativeAfterLocale: string,
+  locale: LocalesValues
+): Promise<string> => {
+  let pendingRead: Promise<string> | undefined;
+
+  const read = (): Promise<string> => {
+    pendingRead ??= readLocaleFile(relativeAfterLocale, locale);
+    return pendingRead;
+  };
+
+  return {
+    // biome-ignore lint/suspicious/noThenProperty: the thenable is intentional — `await` is what triggers the lazy read.
+    then: (onFulfilled, onRejected) => read().then(onFulfilled, onRejected),
+    catch: (onRejected) => read().catch(onRejected),
+    finally: (onFinally) => read().finally(onFinally),
+  } as Promise<string>;
+};
+
 export const frequentQuestionsEntry = {
   './frequent_questions/en/SSR_Next_no_[locale].md': {
     en: readLocale('SSR_Next_no_[locale].md', 'en'),
+    es: readLocale('SSR_Next_no_[locale].md', 'es'),
     ru: readLocale('SSR_Next_no_[locale].md', 'ru'),
     ja: readLocale('SSR_Next_no_[locale].md', 'ja'),
     fr: readLocale('SSR_Next_no_[locale].md', 'fr'),
     ko: readLocale('SSR_Next_no_[locale].md', 'ko'),
     zh: readLocale('SSR_Next_no_[locale].md', 'zh'),
-    es: readLocale('SSR_Next_no_[locale].md', 'es'),
     de: readLocale('SSR_Next_no_[locale].md', 'de'),
     ar: readLocale('SSR_Next_no_[locale].md', 'ar'),
     it: readLocale('SSR_Next_no_[locale].md', 'it'),
@@ -81,12 +113,12 @@ export const frequentQuestionsEntry = {
   } as unknown as Record<LocalesValues, Promise<string>>,
   './frequent_questions/en/array_as_content_declaration.md': {
     en: readLocale('array_as_content_declaration.md', 'en'),
+    es: readLocale('array_as_content_declaration.md', 'es'),
     ru: readLocale('array_as_content_declaration.md', 'ru'),
     ja: readLocale('array_as_content_declaration.md', 'ja'),
     fr: readLocale('array_as_content_declaration.md', 'fr'),
     ko: readLocale('array_as_content_declaration.md', 'ko'),
     zh: readLocale('array_as_content_declaration.md', 'zh'),
-    es: readLocale('array_as_content_declaration.md', 'es'),
     de: readLocale('array_as_content_declaration.md', 'de'),
     ar: readLocale('array_as_content_declaration.md', 'ar'),
     it: readLocale('array_as_content_declaration.md', 'it'),
@@ -101,12 +133,12 @@ export const frequentQuestionsEntry = {
   } as unknown as Record<LocalesValues, Promise<string>>,
   './frequent_questions/en/build_dictionaries.md': {
     en: readLocale('build_dictionaries.md', 'en'),
+    es: readLocale('build_dictionaries.md', 'es'),
     ru: readLocale('build_dictionaries.md', 'ru'),
     ja: readLocale('build_dictionaries.md', 'ja'),
     fr: readLocale('build_dictionaries.md', 'fr'),
     ko: readLocale('build_dictionaries.md', 'ko'),
     zh: readLocale('build_dictionaries.md', 'zh'),
-    es: readLocale('build_dictionaries.md', 'es'),
     de: readLocale('build_dictionaries.md', 'de'),
     ar: readLocale('build_dictionaries.md', 'ar'),
     it: readLocale('build_dictionaries.md', 'it'),
@@ -121,12 +153,12 @@ export const frequentQuestionsEntry = {
   } as unknown as Record<LocalesValues, Promise<string>>,
   './frequent_questions/en/build_error_CI_CD.md': {
     en: readLocale('build_error_CI_CD.md', 'en'),
+    es: readLocale('build_error_CI_CD.md', 'es'),
     ru: readLocale('build_error_CI_CD.md', 'ru'),
     ja: readLocale('build_error_CI_CD.md', 'ja'),
     fr: readLocale('build_error_CI_CD.md', 'fr'),
     ko: readLocale('build_error_CI_CD.md', 'ko'),
     zh: readLocale('build_error_CI_CD.md', 'zh'),
-    es: readLocale('build_error_CI_CD.md', 'es'),
     de: readLocale('build_error_CI_CD.md', 'de'),
     ar: readLocale('build_error_CI_CD.md', 'ar'),
     it: readLocale('build_error_CI_CD.md', 'it'),
@@ -141,12 +173,12 @@ export const frequentQuestionsEntry = {
   } as unknown as Record<LocalesValues, Promise<string>>,
   './frequent_questions/en/bun_set_up.md': {
     en: readLocale('bun_set_up.md', 'en'),
+    es: readLocale('bun_set_up.md', 'es'),
     ru: readLocale('bun_set_up.md', 'ru'),
     ja: readLocale('bun_set_up.md', 'ja'),
     fr: readLocale('bun_set_up.md', 'fr'),
     ko: readLocale('bun_set_up.md', 'ko'),
     zh: readLocale('bun_set_up.md', 'zh'),
-    es: readLocale('bun_set_up.md', 'es'),
     de: readLocale('bun_set_up.md', 'de'),
     ar: readLocale('bun_set_up.md', 'ar'),
     it: readLocale('bun_set_up.md', 'it'),
@@ -161,12 +193,12 @@ export const frequentQuestionsEntry = {
   } as unknown as Record<LocalesValues, Promise<string>>,
   './frequent_questions/en/customized_locale_list.md': {
     en: readLocale('customized_locale_list.md', 'en'),
+    es: readLocale('customized_locale_list.md', 'es'),
     ru: readLocale('customized_locale_list.md', 'ru'),
     ja: readLocale('customized_locale_list.md', 'ja'),
     fr: readLocale('customized_locale_list.md', 'fr'),
     ko: readLocale('customized_locale_list.md', 'ko'),
     zh: readLocale('customized_locale_list.md', 'zh'),
-    es: readLocale('customized_locale_list.md', 'es'),
     de: readLocale('customized_locale_list.md', 'de'),
     ar: readLocale('customized_locale_list.md', 'ar'),
     it: readLocale('customized_locale_list.md', 'it'),
@@ -181,12 +213,12 @@ export const frequentQuestionsEntry = {
   } as unknown as Record<LocalesValues, Promise<string>>,
   './frequent_questions/en/domain_routing.md': {
     en: readLocale('domain_routing.md', 'en'),
+    es: readLocale('domain_routing.md', 'es'),
     ru: readLocale('domain_routing.md', 'ru'),
     ja: readLocale('domain_routing.md', 'ja'),
     fr: readLocale('domain_routing.md', 'fr'),
     ko: readLocale('domain_routing.md', 'ko'),
     zh: readLocale('domain_routing.md', 'zh'),
-    es: readLocale('domain_routing.md', 'es'),
     de: readLocale('domain_routing.md', 'de'),
     ar: readLocale('domain_routing.md', 'ar'),
     it: readLocale('domain_routing.md', 'it'),
@@ -201,12 +233,12 @@ export const frequentQuestionsEntry = {
   } as unknown as Record<LocalesValues, Promise<string>>,
   './frequent_questions/en/error-vite-env-only.md': {
     en: readLocale('error-vite-env-only.md', 'en'),
+    es: readLocale('error-vite-env-only.md', 'es'),
     ru: readLocale('error-vite-env-only.md', 'ru'),
     ja: readLocale('error-vite-env-only.md', 'ja'),
     fr: readLocale('error-vite-env-only.md', 'fr'),
     ko: readLocale('error-vite-env-only.md', 'ko'),
     zh: readLocale('error-vite-env-only.md', 'zh'),
-    es: readLocale('error-vite-env-only.md', 'es'),
     de: readLocale('error-vite-env-only.md', 'de'),
     ar: readLocale('error-vite-env-only.md', 'ar'),
     it: readLocale('error-vite-env-only.md', 'it'),
@@ -221,12 +253,12 @@ export const frequentQuestionsEntry = {
   } as unknown as Record<LocalesValues, Promise<string>>,
   './frequent_questions/en/esbuild_error.md': {
     en: readLocale('esbuild_error.md', 'en'),
+    es: readLocale('esbuild_error.md', 'es'),
     ru: readLocale('esbuild_error.md', 'ru'),
     ja: readLocale('esbuild_error.md', 'ja'),
     fr: readLocale('esbuild_error.md', 'fr'),
     ko: readLocale('esbuild_error.md', 'ko'),
     zh: readLocale('esbuild_error.md', 'zh'),
-    es: readLocale('esbuild_error.md', 'es'),
     de: readLocale('esbuild_error.md', 'de'),
     ar: readLocale('esbuild_error.md', 'ar'),
     it: readLocale('esbuild_error.md', 'it'),
@@ -241,12 +273,12 @@ export const frequentQuestionsEntry = {
   } as unknown as Record<LocalesValues, Promise<string>>,
   './frequent_questions/en/get_locale_cookie.md': {
     en: readLocale('get_locale_cookie.md', 'en'),
+    es: readLocale('get_locale_cookie.md', 'es'),
     ru: readLocale('get_locale_cookie.md', 'ru'),
     ja: readLocale('get_locale_cookie.md', 'ja'),
     fr: readLocale('get_locale_cookie.md', 'fr'),
     ko: readLocale('get_locale_cookie.md', 'ko'),
     zh: readLocale('get_locale_cookie.md', 'zh'),
-    es: readLocale('get_locale_cookie.md', 'es'),
     de: readLocale('get_locale_cookie.md', 'de'),
     ar: readLocale('get_locale_cookie.md', 'ar'),
     it: readLocale('get_locale_cookie.md', 'it'),
@@ -261,12 +293,12 @@ export const frequentQuestionsEntry = {
   } as unknown as Record<LocalesValues, Promise<string>>,
   './frequent_questions/en/intlayerNode.md': {
     en: readLocale('intlayerNode.md', 'en'),
+    es: readLocale('intlayerNode.md', 'es'),
     ru: readLocale('intlayerNode.md', 'ru'),
     ja: readLocale('intlayerNode.md', 'ja'),
     fr: readLocale('intlayerNode.md', 'fr'),
     ko: readLocale('intlayerNode.md', 'ko'),
     zh: readLocale('intlayerNode.md', 'zh'),
-    es: readLocale('intlayerNode.md', 'es'),
     de: readLocale('intlayerNode.md', 'de'),
     ar: readLocale('intlayerNode.md', 'ar'),
     it: readLocale('intlayerNode.md', 'it'),
@@ -281,12 +313,12 @@ export const frequentQuestionsEntry = {
   } as unknown as Record<LocalesValues, Promise<string>>,
   './frequent_questions/en/intlayer_command_undefined.md': {
     en: readLocale('intlayer_command_undefined.md', 'en'),
+    es: readLocale('intlayer_command_undefined.md', 'es'),
     ru: readLocale('intlayer_command_undefined.md', 'ru'),
     ja: readLocale('intlayer_command_undefined.md', 'ja'),
     fr: readLocale('intlayer_command_undefined.md', 'fr'),
     ko: readLocale('intlayer_command_undefined.md', 'ko'),
     zh: readLocale('intlayer_command_undefined.md', 'zh'),
-    es: readLocale('intlayer_command_undefined.md', 'es'),
     de: readLocale('intlayer_command_undefined.md', 'de'),
     ar: readLocale('intlayer_command_undefined.md', 'ar'),
     it: readLocale('intlayer_command_undefined.md', 'it'),
@@ -301,12 +333,12 @@ export const frequentQuestionsEntry = {
   } as unknown as Record<LocalesValues, Promise<string>>,
   './frequent_questions/en/locale_incorect_in_url.md': {
     en: readLocale('locale_incorect_in_url.md', 'en'),
+    es: readLocale('locale_incorect_in_url.md', 'es'),
     ru: readLocale('locale_incorect_in_url.md', 'ru'),
     ja: readLocale('locale_incorect_in_url.md', 'ja'),
     fr: readLocale('locale_incorect_in_url.md', 'fr'),
     ko: readLocale('locale_incorect_in_url.md', 'ko'),
     zh: readLocale('locale_incorect_in_url.md', 'zh'),
-    es: readLocale('locale_incorect_in_url.md', 'es'),
     de: readLocale('locale_incorect_in_url.md', 'de'),
     ar: readLocale('locale_incorect_in_url.md', 'ar'),
     it: readLocale('locale_incorect_in_url.md', 'it'),
@@ -321,12 +353,12 @@ export const frequentQuestionsEntry = {
   } as unknown as Record<LocalesValues, Promise<string>>,
   './frequent_questions/en/package_version_error.md': {
     en: readLocale('package_version_error.md', 'en'),
+    es: readLocale('package_version_error.md', 'es'),
     ru: readLocale('package_version_error.md', 'ru'),
     ja: readLocale('package_version_error.md', 'ja'),
     fr: readLocale('package_version_error.md', 'fr'),
     ko: readLocale('package_version_error.md', 'ko'),
     zh: readLocale('package_version_error.md', 'zh'),
-    es: readLocale('package_version_error.md', 'es'),
     de: readLocale('package_version_error.md', 'de'),
     ar: readLocale('package_version_error.md', 'ar'),
     it: readLocale('package_version_error.md', 'it'),
@@ -341,12 +373,12 @@ export const frequentQuestionsEntry = {
   } as unknown as Record<LocalesValues, Promise<string>>,
   './frequent_questions/en/static_rendering.md': {
     en: readLocale('static_rendering.md', 'en'),
+    es: readLocale('static_rendering.md', 'es'),
     ru: readLocale('static_rendering.md', 'ru'),
     ja: readLocale('static_rendering.md', 'ja'),
     fr: readLocale('static_rendering.md', 'fr'),
     ko: readLocale('static_rendering.md', 'ko'),
     zh: readLocale('static_rendering.md', 'zh'),
-    es: readLocale('static_rendering.md', 'es'),
     de: readLocale('static_rendering.md', 'de'),
     ar: readLocale('static_rendering.md', 'ar'),
     it: readLocale('static_rendering.md', 'it'),
@@ -361,12 +393,12 @@ export const frequentQuestionsEntry = {
   } as unknown as Record<LocalesValues, Promise<string>>,
   './frequent_questions/en/translated_path_url.md': {
     en: readLocale('translated_path_url.md', 'en'),
+    es: readLocale('translated_path_url.md', 'es'),
     ru: readLocale('translated_path_url.md', 'ru'),
     ja: readLocale('translated_path_url.md', 'ja'),
     fr: readLocale('translated_path_url.md', 'fr'),
     ko: readLocale('translated_path_url.md', 'ko'),
     zh: readLocale('translated_path_url.md', 'zh'),
-    es: readLocale('translated_path_url.md', 'es'),
     de: readLocale('translated_path_url.md', 'de'),
     ar: readLocale('translated_path_url.md', 'ar'),
     it: readLocale('translated_path_url.md', 'it'),
@@ -381,12 +413,12 @@ export const frequentQuestionsEntry = {
   } as unknown as Record<LocalesValues, Promise<string>>,
   './frequent_questions/en/unknown_command.md': {
     en: readLocale('unknown_command.md', 'en'),
+    es: readLocale('unknown_command.md', 'es'),
     ru: readLocale('unknown_command.md', 'ru'),
     ja: readLocale('unknown_command.md', 'ja'),
     fr: readLocale('unknown_command.md', 'fr'),
     ko: readLocale('unknown_command.md', 'ko'),
     zh: readLocale('unknown_command.md', 'zh'),
-    es: readLocale('unknown_command.md', 'es'),
     de: readLocale('unknown_command.md', 'de'),
     ar: readLocale('unknown_command.md', 'ar'),
     it: readLocale('unknown_command.md', 'it'),

package/src/generated/legal.entry.ts

@@ -32,35 +32,67 @@ try {
   }
 }
 
-const readLocale = (
+/**
+ * Reads a document, preferring the requested locale and falling back to English.
+ */
+const readLocaleFile = async (
   relativeAfterLocale: string,
   locale: LocalesValues
 ): Promise<string> => {
   const target1 = join(baseDir, `./legal/${locale}/${relativeAfterLocale}`);
   if (existsSync(target1)) {
-    return readFile(target1, 'utf8');
+    return await readFile(target1, 'utf8');
   }
   const target2 = join(baseDir, `./legal/en/${relativeAfterLocale}`);
   if (existsSync(target2)) {
-    return readFile(target2, 'utf8');
+    return await readFile(target2, 'utf8');
   }
 
-  return Promise.reject(
-    new Error(
-      `[docs] File not found: ${relativeAfterLocale} - locale: ${locale} - path: ${target1} - path: ${target2}`
-    )
+  throw new Error(
+    `[docs] File not found: ${relativeAfterLocale} - locale: ${locale} - path: ${target1} - path: ${target2}`
   );
 };
 
+/**
+ * Builds a lazy, awaitable handle over a document.
+ *
+ * The entry map below holds one handle per document *per locale*, so reading
+ * eagerly would pull every markdown file of every locale into memory as soon as
+ * this module is imported — hundreds of megabytes, duplicated in every
+ * prerender worker, for the handful of documents a page actually renders.
+ *
+ * The returned value is a thenable rather than a promise: consumers only ever
+ * `await` it, and `await` triggers `then`, so the file is read on first use and
+ * the resulting promise is cached for subsequent reads.
+ */
+const readLocale = (
+  relativeAfterLocale: string,
+  locale: LocalesValues
+): Promise<string> => {
+  let pendingRead: Promise<string> | undefined;
+
+  const read = (): Promise<string> => {
+    pendingRead ??= readLocaleFile(relativeAfterLocale, locale);
+    return pendingRead;
+  };
+
+  return {
+    // biome-ignore lint/suspicious/noThenProperty: the thenable is intentional — `await` is what triggers the lazy read.
+    then: (onFulfilled, onRejected) => read().then(onFulfilled, onRejected),
+    catch: (onRejected) => read().catch(onRejected),
+    finally: (onFinally) => read().finally(onFinally),
+  } as Promise<string>;
+};
+
 export const legalEntry = {
   './legal/en/privacy_notice.md': {
     en: readLocale('privacy_notice.md', 'en'),
+    es: readLocale('privacy_notice.md', 'es'),
     ru: readLocale('privacy_notice.md', 'ru'),
     ja: readLocale('privacy_notice.md', 'ja'),
     fr: readLocale('privacy_notice.md', 'fr'),
     ko: readLocale('privacy_notice.md', 'ko'),
     zh: readLocale('privacy_notice.md', 'zh'),
-    es: readLocale('privacy_notice.md', 'es'),
     de: readLocale('privacy_notice.md', 'de'),
     ar: readLocale('privacy_notice.md', 'ar'),
     it: readLocale('privacy_notice.md', 'it'),
@@ -75,12 +107,12 @@ export const legalEntry = {
   } as unknown as Record<LocalesValues, Promise<string>>,
   './legal/en/terms_of_service.md': {
     en: readLocale('terms_of_service.md', 'en'),
+    es: readLocale('terms_of_service.md', 'es'),
     ru: readLocale('terms_of_service.md', 'ru'),
     ja: readLocale('terms_of_service.md', 'ja'),
     fr: readLocale('terms_of_service.md', 'fr'),
     ko: readLocale('terms_of_service.md', 'ko'),
     zh: readLocale('terms_of_service.md', 'zh'),
-    es: readLocale('terms_of_service.md', 'es'),
     de: readLocale('terms_of_service.md', 'de'),
     ar: readLocale('terms_of_service.md', 'ar'),
     it: readLocale('terms_of_service.md', 'it'),