@intlayer/docs 9.1.3 → 9.3.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@intlayer/docs",
-  "version": "9.1.3",
+  "version": "9.3.0",
   "private": false,
   "description": "Intlayer documentation",
   "keywords": [
@@ -73,14 +73,14 @@
     "watch": "webpack --config ./webpack.config.ts --watch"
   },
   "dependencies": {
-    "@intlayer/config": "9.1.3",
-    "@intlayer/core": "9.1.3",
-    "@intlayer/types": "9.1.3"
+    "@intlayer/config": "9.3.0",
+    "@intlayer/core": "9.3.0",
+    "@intlayer/types": "9.3.0"
   },
   "devDependencies": {
-    "@intlayer/api": "9.1.3",
-    "@intlayer/cli": "9.1.3",
-    "@types/node": "26.1.2",
+    "@intlayer/api": "9.3.0",
+    "@intlayer/cli": "9.3.0",
+    "@types/node": "26.2.0",
     "@utils/ts-config": "1.0.4",
     "@utils/ts-config-types": "1.0.4",
     "@utils/tsdown-config": "1.0.4",

package/src/common.ts

@@ -131,11 +131,25 @@ export const getFileMetadata = async <
   return formatMetadata(docKey as string, file, locale) as R;
 };
 
-export const getFileMetadataRecord = async <
+/**
+ * Per-locale metadata records, keyed by the entry map they were built from.
+ *
+ * Building a record parses the frontmatter of every document of a category, and
+ * callers such as {@link getFileMetadataBySlug} need the whole record just to
+ * resolve a single slug — which a static site generator repeats for every page
+ * it renders. Documents are read once per process anyway (each entry caches its
+ * own read), so the derived metadata is equally safe to keep.
+ */
+const fileMetadataRecordCache = new WeakMap<
+  Record<string, unknown>,
+  Map<LocalesValues, Promise<Record<string, FileMetadata>>>
+>();
+
+const buildFileMetadataRecord = async <
   F extends Record<string, Record<LocalesValues, Promise<string>>>,
 >(
   files: F,
-  locale: LocalesValues = defaultLocale as LocalesValues
+  locale: LocalesValues
 ): Promise<Record<keyof F, FileMetadata>> => {
   const results = await Promise.allSettled(
     Object.entries(files).map(async ([key]) => {
@@ -153,6 +167,29 @@ export const getFileMetadataRecord = async <
   return filesResult as Record<keyof F, FileMetadata>;
 };
 
+export const getFileMetadataRecord = async <
+  F extends Record<string, Record<LocalesValues, Promise<string>>>,
+>(
+  files: F,
+  locale: LocalesValues = defaultLocale as LocalesValues
+): Promise<Record<keyof F, FileMetadata>> => {
+  let localeCache = fileMetadataRecordCache.get(files);
+
+  if (!localeCache) {
+    localeCache = new Map();
+    fileMetadataRecordCache.set(files, localeCache);
+  }
+
+  let record = localeCache.get(locale);
+
+  if (!record) {
+    record = buildFileMetadataRecord(files, locale);
+    localeCache.set(locale, record);
+  }
+
+  return (await record) as Record<keyof F, FileMetadata>;
+};
+
 export const getFileMetadataBySlug = async <
   F extends Record<string, Record<LocalesValues, Promise<string>>>,
 >(

package/src/generated/blog.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, `./blog/${locale}/${relativeAfterLocale}`);
   if (existsSync(target1)) {
-    return readFile(target1, 'utf8');
+    return await readFile(target1, 'utf8');
   }
   const target2 = join(baseDir, `./blog/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 blogEntry = {
   './blog/en/compiler_vs_declarative_i18n.md': {
     en: readLocale('compiler_vs_declarative_i18n.md', 'en'),
+    es: readLocale('compiler_vs_declarative_i18n.md', 'es'),
     ru: readLocale('compiler_vs_declarative_i18n.md', 'ru'),
     ja: readLocale('compiler_vs_declarative_i18n.md', 'ja'),
     fr: readLocale('compiler_vs_declarative_i18n.md', 'fr'),
     ko: readLocale('compiler_vs_declarative_i18n.md', 'ko'),
     zh: readLocale('compiler_vs_declarative_i18n.md', 'zh'),
-    es: readLocale('compiler_vs_declarative_i18n.md', 'es'),
     de: readLocale('compiler_vs_declarative_i18n.md', 'de'),
     ar: readLocale('compiler_vs_declarative_i18n.md', 'ar'),
     it: readLocale('compiler_vs_declarative_i18n.md', 'it'),
@@ -75,12 +107,12 @@ export const blogEntry = {
   } as unknown as Record<LocalesValues, Promise<string>>,
   './blog/en/i18n_meaning.md': {
     en: readLocale('i18n_meaning.md', 'en'),
+    es: readLocale('i18n_meaning.md', 'es'),
     ru: readLocale('i18n_meaning.md', 'ru'),
     ja: readLocale('i18n_meaning.md', 'ja'),
     fr: readLocale('i18n_meaning.md', 'fr'),
     ko: readLocale('i18n_meaning.md', 'ko'),
     zh: readLocale('i18n_meaning.md', 'zh'),
-    es: readLocale('i18n_meaning.md', 'es'),
     de: readLocale('i18n_meaning.md', 'de'),
     ar: readLocale('i18n_meaning.md', 'ar'),
     it: readLocale('i18n_meaning.md', 'it'),
@@ -95,12 +127,12 @@ export const blogEntry = {
   } as unknown as Record<LocalesValues, Promise<string>>,
   './blog/en/i18n_using_next-i18next.md': {
     en: readLocale('i18n_using_next-i18next.md', 'en'),
+    es: readLocale('i18n_using_next-i18next.md', 'es'),
     ru: readLocale('i18n_using_next-i18next.md', 'ru'),
     ja: readLocale('i18n_using_next-i18next.md', 'ja'),
     fr: readLocale('i18n_using_next-i18next.md', 'fr'),
     ko: readLocale('i18n_using_next-i18next.md', 'ko'),
     zh: readLocale('i18n_using_next-i18next.md', 'zh'),
-    es: readLocale('i18n_using_next-i18next.md', 'es'),
     de: readLocale('i18n_using_next-i18next.md', 'de'),
     ar: readLocale('i18n_using_next-i18next.md', 'ar'),
     it: readLocale('i18n_using_next-i18next.md', 'it'),
@@ -115,12 +147,12 @@ export const blogEntry = {
   } as unknown as Record<LocalesValues, Promise<string>>,
   './blog/en/i18n_using_next-intl.md': {
     en: readLocale('i18n_using_next-intl.md', 'en'),
+    es: readLocale('i18n_using_next-intl.md', 'es'),
     ru: readLocale('i18n_using_next-intl.md', 'ru'),
     ja: readLocale('i18n_using_next-intl.md', 'ja'),
     fr: readLocale('i18n_using_next-intl.md', 'fr'),
     ko: readLocale('i18n_using_next-intl.md', 'ko'),
     zh: readLocale('i18n_using_next-intl.md', 'zh'),
-    es: readLocale('i18n_using_next-intl.md', 'es'),
     de: readLocale('i18n_using_next-intl.md', 'de'),
     ar: readLocale('i18n_using_next-intl.md', 'ar'),
     it: readLocale('i18n_using_next-intl.md', 'it'),
@@ -135,12 +167,12 @@ export const blogEntry = {
   } as unknown as Record<LocalesValues, Promise<string>>,
   './blog/en/index.md': {
     en: readLocale('index.md', 'en'),
+    es: readLocale('index.md', 'es'),
     ru: readLocale('index.md', 'ru'),
     ja: readLocale('index.md', 'ja'),
     fr: readLocale('index.md', 'fr'),
     ko: readLocale('index.md', 'ko'),
     zh: readLocale('index.md', 'zh'),
-    es: readLocale('index.md', 'es'),
     de: readLocale('index.md', 'de'),
     ar: readLocale('index.md', 'ar'),
     it: readLocale('index.md', 'it'),
@@ -155,12 +187,12 @@ export const blogEntry = {
   } as unknown as Record<LocalesValues, Promise<string>>,
   './blog/en/internationalization_and_SEO.md': {
     en: readLocale('internationalization_and_SEO.md', 'en'),
+    es: readLocale('internationalization_and_SEO.md', 'es'),
     ru: readLocale('internationalization_and_SEO.md', 'ru'),
     ja: readLocale('internationalization_and_SEO.md', 'ja'),
     fr: readLocale('internationalization_and_SEO.md', 'fr'),
     ko: readLocale('internationalization_and_SEO.md', 'ko'),
     zh: readLocale('internationalization_and_SEO.md', 'zh'),
-    es: readLocale('internationalization_and_SEO.md', 'es'),
     de: readLocale('internationalization_and_SEO.md', 'de'),
     ar: readLocale('internationalization_and_SEO.md', 'ar'),
     it: readLocale('internationalization_and_SEO.md', 'it'),
@@ -175,12 +207,12 @@ export const blogEntry = {
   } as unknown as Record<LocalesValues, Promise<string>>,
   './blog/en/intlayer_with_i18next.md': {
     en: readLocale('intlayer_with_i18next.md', 'en'),
+    es: readLocale('intlayer_with_i18next.md', 'es'),
     ru: readLocale('intlayer_with_i18next.md', 'ru'),
     ja: readLocale('intlayer_with_i18next.md', 'ja'),
     fr: readLocale('intlayer_with_i18next.md', 'fr'),
     ko: readLocale('intlayer_with_i18next.md', 'ko'),
     zh: readLocale('intlayer_with_i18next.md', 'zh'),
-    es: readLocale('intlayer_with_i18next.md', 'es'),
     de: readLocale('intlayer_with_i18next.md', 'de'),
     ar: readLocale('intlayer_with_i18next.md', 'ar'),
     it: readLocale('intlayer_with_i18next.md', 'it'),
@@ -195,12 +227,12 @@ export const blogEntry = {
   } as unknown as Record<LocalesValues, Promise<string>>,
   './blog/en/intlayer_with_next-i18next.md': {
     en: readLocale('intlayer_with_next-i18next.md', 'en'),
+    es: readLocale('intlayer_with_next-i18next.md', 'es'),
     ru: readLocale('intlayer_with_next-i18next.md', 'ru'),
     ja: readLocale('intlayer_with_next-i18next.md', 'ja'),
     fr: readLocale('intlayer_with_next-i18next.md', 'fr'),
     ko: readLocale('intlayer_with_next-i18next.md', 'ko'),
     zh: readLocale('intlayer_with_next-i18next.md', 'zh'),
-    es: readLocale('intlayer_with_next-i18next.md', 'es'),
     de: readLocale('intlayer_with_next-i18next.md', 'de'),
     ar: readLocale('intlayer_with_next-i18next.md', 'ar'),
     it: readLocale('intlayer_with_next-i18next.md', 'it'),
@@ -215,12 +247,12 @@ export const blogEntry = {
   } as unknown as Record<LocalesValues, Promise<string>>,
   './blog/en/intlayer_with_next-intl.md': {
     en: readLocale('intlayer_with_next-intl.md', 'en'),
+    es: readLocale('intlayer_with_next-intl.md', 'es'),
     ru: readLocale('intlayer_with_next-intl.md', 'ru'),
     ja: readLocale('intlayer_with_next-intl.md', 'ja'),
     fr: readLocale('intlayer_with_next-intl.md', 'fr'),
     ko: readLocale('intlayer_with_next-intl.md', 'ko'),
     zh: readLocale('intlayer_with_next-intl.md', 'zh'),
-    es: readLocale('intlayer_with_next-intl.md', 'es'),
     de: readLocale('intlayer_with_next-intl.md', 'de'),
     ar: readLocale('intlayer_with_next-intl.md', 'ar'),
     it: readLocale('intlayer_with_next-intl.md', 'it'),
@@ -235,12 +267,12 @@ export const blogEntry = {
   } as unknown as Record<LocalesValues, Promise<string>>,
   './blog/en/intlayer_with_react-i18next.md': {
     en: readLocale('intlayer_with_react-i18next.md', 'en'),
+    es: readLocale('intlayer_with_react-i18next.md', 'es'),
     ru: readLocale('intlayer_with_react-i18next.md', 'ru'),
     ja: readLocale('intlayer_with_react-i18next.md', 'ja'),
     fr: readLocale('intlayer_with_react-i18next.md', 'fr'),
     ko: readLocale('intlayer_with_react-i18next.md', 'ko'),
     zh: readLocale('intlayer_with_react-i18next.md', 'zh'),
-    es: readLocale('intlayer_with_react-i18next.md', 'es'),
     de: readLocale('intlayer_with_react-i18next.md', 'de'),
     ar: readLocale('intlayer_with_react-i18next.md', 'ar'),
     it: readLocale('intlayer_with_react-i18next.md', 'it'),
@@ -255,12 +287,12 @@ export const blogEntry = {
   } as unknown as Record<LocalesValues, Promise<string>>,
   './blog/en/intlayer_with_react-intl.md': {
     en: readLocale('intlayer_with_react-intl.md', 'en'),
+    es: readLocale('intlayer_with_react-intl.md', 'es'),
     ru: readLocale('intlayer_with_react-intl.md', 'ru'),
     ja: readLocale('intlayer_with_react-intl.md', 'ja'),
     fr: readLocale('intlayer_with_react-intl.md', 'fr'),
     ko: readLocale('intlayer_with_react-intl.md', 'ko'),
     zh: readLocale('intlayer_with_react-intl.md', 'zh'),
-    es: readLocale('intlayer_with_react-intl.md', 'es'),
     de: readLocale('intlayer_with_react-intl.md', 'de'),
     ar: readLocale('intlayer_with_react-intl.md', 'ar'),
     it: readLocale('intlayer_with_react-intl.md', 'it'),
@@ -275,12 +307,12 @@ export const blogEntry = {
   } as unknown as Record<LocalesValues, Promise<string>>,
   './blog/en/intlayer_with_vue-i18n.md': {
     en: readLocale('intlayer_with_vue-i18n.md', 'en'),
+    es: readLocale('intlayer_with_vue-i18n.md', 'es'),
     ru: readLocale('intlayer_with_vue-i18n.md', 'ru'),
     ja: readLocale('intlayer_with_vue-i18n.md', 'ja'),
     fr: readLocale('intlayer_with_vue-i18n.md', 'fr'),
     ko: readLocale('intlayer_with_vue-i18n.md', 'ko'),
     zh: readLocale('intlayer_with_vue-i18n.md', 'zh'),
-    es: readLocale('intlayer_with_vue-i18n.md', 'es'),
     de: readLocale('intlayer_with_vue-i18n.md', 'de'),
     ar: readLocale('intlayer_with_vue-i18n.md', 'ar'),
     it: readLocale('intlayer_with_vue-i18n.md', 'it'),
@@ -295,12 +327,12 @@ export const blogEntry = {
   } as unknown as Record<LocalesValues, Promise<string>>,
   './blog/en/l10n_platform_alternative/Lokalise.md': {
     en: readLocale('l10n_platform_alternative/Lokalise.md', 'en'),
+    es: readLocale('l10n_platform_alternative/Lokalise.md', 'es'),
     ru: readLocale('l10n_platform_alternative/Lokalise.md', 'ru'),
     ja: readLocale('l10n_platform_alternative/Lokalise.md', 'ja'),
     fr: readLocale('l10n_platform_alternative/Lokalise.md', 'fr'),
     ko: readLocale('l10n_platform_alternative/Lokalise.md', 'ko'),
     zh: readLocale('l10n_platform_alternative/Lokalise.md', 'zh'),
-    es: readLocale('l10n_platform_alternative/Lokalise.md', 'es'),
     de: readLocale('l10n_platform_alternative/Lokalise.md', 'de'),
     ar: readLocale('l10n_platform_alternative/Lokalise.md', 'ar'),
     it: readLocale('l10n_platform_alternative/Lokalise.md', 'it'),
@@ -315,12 +347,12 @@ export const blogEntry = {
   } as unknown as Record<LocalesValues, Promise<string>>,
   './blog/en/l10n_platform_alternative/crowdin.md': {
     en: readLocale('l10n_platform_alternative/crowdin.md', 'en'),
+    es: readLocale('l10n_platform_alternative/crowdin.md', 'es'),
     ru: readLocale('l10n_platform_alternative/crowdin.md', 'ru'),
     ja: readLocale('l10n_platform_alternative/crowdin.md', 'ja'),
     fr: readLocale('l10n_platform_alternative/crowdin.md', 'fr'),
     ko: readLocale('l10n_platform_alternative/crowdin.md', 'ko'),
     zh: readLocale('l10n_platform_alternative/crowdin.md', 'zh'),
-    es: readLocale('l10n_platform_alternative/crowdin.md', 'es'),
     de: readLocale('l10n_platform_alternative/crowdin.md', 'de'),
     ar: readLocale('l10n_platform_alternative/crowdin.md', 'ar'),
     it: readLocale('l10n_platform_alternative/crowdin.md', 'it'),
@@ -335,12 +367,12 @@ export const blogEntry = {
   } as unknown as Record<LocalesValues, Promise<string>>,
   './blog/en/l10n_platform_alternative/phrase.md': {
     en: readLocale('l10n_platform_alternative/phrase.md', 'en'),
+    es: readLocale('l10n_platform_alternative/phrase.md', 'es'),
     ru: readLocale('l10n_platform_alternative/phrase.md', 'ru'),
     ja: readLocale('l10n_platform_alternative/phrase.md', 'ja'),
     fr: readLocale('l10n_platform_alternative/phrase.md', 'fr'),
     ko: readLocale('l10n_platform_alternative/phrase.md', 'ko'),
     zh: readLocale('l10n_platform_alternative/phrase.md', 'zh'),
-    es: readLocale('l10n_platform_alternative/phrase.md', 'es'),
     de: readLocale('l10n_platform_alternative/phrase.md', 'de'),
     ar: readLocale('l10n_platform_alternative/phrase.md', 'ar'),
     it: readLocale('l10n_platform_alternative/phrase.md', 'it'),
@@ -355,12 +387,12 @@ export const blogEntry = {
   } as unknown as Record<LocalesValues, Promise<string>>,
   './blog/en/list_i18n_technologies/frameworks/angular.md': {
     en: readLocale('list_i18n_technologies/frameworks/angular.md', 'en'),
+    es: readLocale('list_i18n_technologies/frameworks/angular.md', 'es'),
     ru: readLocale('list_i18n_technologies/frameworks/angular.md', 'ru'),
     ja: readLocale('list_i18n_technologies/frameworks/angular.md', 'ja'),
     fr: readLocale('list_i18n_technologies/frameworks/angular.md', 'fr'),
     ko: readLocale('list_i18n_technologies/frameworks/angular.md', 'ko'),
     zh: readLocale('list_i18n_technologies/frameworks/angular.md', 'zh'),
-    es: readLocale('list_i18n_technologies/frameworks/angular.md', 'es'),
     de: readLocale('list_i18n_technologies/frameworks/angular.md', 'de'),
     ar: readLocale('list_i18n_technologies/frameworks/angular.md', 'ar'),
     it: readLocale('list_i18n_technologies/frameworks/angular.md', 'it'),
@@ -378,12 +410,12 @@ export const blogEntry = {
   } as unknown as Record<LocalesValues, Promise<string>>,
   './blog/en/list_i18n_technologies/frameworks/react-native.md': {
     en: readLocale('list_i18n_technologies/frameworks/react-native.md', 'en'),
+    es: readLocale('list_i18n_technologies/frameworks/react-native.md', 'es'),
     ru: readLocale('list_i18n_technologies/frameworks/react-native.md', 'ru'),
     ja: readLocale('list_i18n_technologies/frameworks/react-native.md', 'ja'),
     fr: readLocale('list_i18n_technologies/frameworks/react-native.md', 'fr'),
     ko: readLocale('list_i18n_technologies/frameworks/react-native.md', 'ko'),
     zh: readLocale('list_i18n_technologies/frameworks/react-native.md', 'zh'),
-    es: readLocale('list_i18n_technologies/frameworks/react-native.md', 'es'),
     de: readLocale('list_i18n_technologies/frameworks/react-native.md', 'de'),
     ar: readLocale('list_i18n_technologies/frameworks/react-native.md', 'ar'),
     it: readLocale('list_i18n_technologies/frameworks/react-native.md', 'it'),
@@ -401,12 +433,12 @@ export const blogEntry = {
   } as unknown as Record<LocalesValues, Promise<string>>,
   './blog/en/list_i18n_technologies/frameworks/react.md': {
     en: readLocale('list_i18n_technologies/frameworks/react.md', 'en'),
+    es: readLocale('list_i18n_technologies/frameworks/react.md', 'es'),
     ru: readLocale('list_i18n_technologies/frameworks/react.md', 'ru'),
     ja: readLocale('list_i18n_technologies/frameworks/react.md', 'ja'),
     fr: readLocale('list_i18n_technologies/frameworks/react.md', 'fr'),
     ko: readLocale('list_i18n_technologies/frameworks/react.md', 'ko'),
     zh: readLocale('list_i18n_technologies/frameworks/react.md', 'zh'),
-    es: readLocale('list_i18n_technologies/frameworks/react.md', 'es'),
     de: readLocale('list_i18n_technologies/frameworks/react.md', 'de'),
     ar: readLocale('list_i18n_technologies/frameworks/react.md', 'ar'),
     it: readLocale('list_i18n_technologies/frameworks/react.md', 'it'),
@@ -421,12 +453,12 @@ export const blogEntry = {
   } as unknown as Record<LocalesValues, Promise<string>>,
   './blog/en/list_i18n_technologies/frameworks/svelte.md': {
     en: readLocale('list_i18n_technologies/frameworks/svelte.md', 'en'),
+    es: readLocale('list_i18n_technologies/frameworks/svelte.md', 'es'),
     ru: readLocale('list_i18n_technologies/frameworks/svelte.md', 'ru'),
     ja: readLocale('list_i18n_technologies/frameworks/svelte.md', 'ja'),
     fr: readLocale('list_i18n_technologies/frameworks/svelte.md', 'fr'),
     ko: readLocale('list_i18n_technologies/frameworks/svelte.md', 'ko'),
     zh: readLocale('list_i18n_technologies/frameworks/svelte.md', 'zh'),
-    es: readLocale('list_i18n_technologies/frameworks/svelte.md', 'es'),
     de: readLocale('list_i18n_technologies/frameworks/svelte.md', 'de'),
     ar: readLocale('list_i18n_technologies/frameworks/svelte.md', 'ar'),
     it: readLocale('list_i18n_technologies/frameworks/svelte.md', 'it'),
@@ -441,12 +473,12 @@ export const blogEntry = {
   } as unknown as Record<LocalesValues, Promise<string>>,
   './blog/en/list_i18n_technologies/frameworks/vue.md': {
     en: readLocale('list_i18n_technologies/frameworks/vue.md', 'en'),
+    es: readLocale('list_i18n_technologies/frameworks/vue.md', 'es'),
     ru: readLocale('list_i18n_technologies/frameworks/vue.md', 'ru'),
     ja: readLocale('list_i18n_technologies/frameworks/vue.md', 'ja'),
     fr: readLocale('list_i18n_technologies/frameworks/vue.md', 'fr'),
     ko: readLocale('list_i18n_technologies/frameworks/vue.md', 'ko'),
     zh: readLocale('list_i18n_technologies/frameworks/vue.md', 'zh'),
-    es: readLocale('list_i18n_technologies/frameworks/vue.md', 'es'),
     de: readLocale('list_i18n_technologies/frameworks/vue.md', 'de'),
     ar: readLocale('list_i18n_technologies/frameworks/vue.md', 'ar'),
     it: readLocale('list_i18n_technologies/frameworks/vue.md', 'it'),
@@ -461,12 +493,12 @@ export const blogEntry = {
   } as unknown as Record<LocalesValues, Promise<string>>,
   './blog/en/next-i18next_vs_next-intl_vs_intlayer.md': {
     en: readLocale('next-i18next_vs_next-intl_vs_intlayer.md', 'en'),
+    es: readLocale('next-i18next_vs_next-intl_vs_intlayer.md', 'es'),
     ru: readLocale('next-i18next_vs_next-intl_vs_intlayer.md', 'ru'),
     ja: readLocale('next-i18next_vs_next-intl_vs_intlayer.md', 'ja'),
     fr: readLocale('next-i18next_vs_next-intl_vs_intlayer.md', 'fr'),
     ko: readLocale('next-i18next_vs_next-intl_vs_intlayer.md', 'ko'),
     zh: readLocale('next-i18next_vs_next-intl_vs_intlayer.md', 'zh'),
-    es: readLocale('next-i18next_vs_next-intl_vs_intlayer.md', 'es'),
     de: readLocale('next-i18next_vs_next-intl_vs_intlayer.md', 'de'),
     ar: readLocale('next-i18next_vs_next-intl_vs_intlayer.md', 'ar'),
     it: readLocale('next-i18next_vs_next-intl_vs_intlayer.md', 'it'),
@@ -481,12 +513,12 @@ export const blogEntry = {
   } as unknown as Record<LocalesValues, Promise<string>>,
   './blog/en/nextjs-multilingual-seo-comparison.md': {
     en: readLocale('nextjs-multilingual-seo-comparison.md', 'en'),
+    es: readLocale('nextjs-multilingual-seo-comparison.md', 'es'),
     ru: readLocale('nextjs-multilingual-seo-comparison.md', 'ru'),
     ja: readLocale('nextjs-multilingual-seo-comparison.md', 'ja'),
     fr: readLocale('nextjs-multilingual-seo-comparison.md', 'fr'),
     ko: readLocale('nextjs-multilingual-seo-comparison.md', 'ko'),
     zh: readLocale('nextjs-multilingual-seo-comparison.md', 'zh'),
-    es: readLocale('nextjs-multilingual-seo-comparison.md', 'es'),
     de: readLocale('nextjs-multilingual-seo-comparison.md', 'de'),
     ar: readLocale('nextjs-multilingual-seo-comparison.md', 'ar'),
     it: readLocale('nextjs-multilingual-seo-comparison.md', 'it'),
@@ -501,12 +533,12 @@ export const blogEntry = {
   } as unknown as Record<LocalesValues, Promise<string>>,
   './blog/en/per-component_vs_centralized_i18n.md': {
     en: readLocale('per-component_vs_centralized_i18n.md', 'en'),
+    es: readLocale('per-component_vs_centralized_i18n.md', 'es'),
     ru: readLocale('per-component_vs_centralized_i18n.md', 'ru'),
     ja: readLocale('per-component_vs_centralized_i18n.md', 'ja'),
     fr: readLocale('per-component_vs_centralized_i18n.md', 'fr'),
     ko: readLocale('per-component_vs_centralized_i18n.md', 'ko'),
     zh: readLocale('per-component_vs_centralized_i18n.md', 'zh'),
-    es: readLocale('per-component_vs_centralized_i18n.md', 'es'),
     de: readLocale('per-component_vs_centralized_i18n.md', 'de'),
     ar: readLocale('per-component_vs_centralized_i18n.md', 'ar'),
     it: readLocale('per-component_vs_centralized_i18n.md', 'it'),
@@ -521,12 +553,12 @@ export const blogEntry = {
   } as unknown as Record<LocalesValues, Promise<string>>,
   './blog/en/rag_powered_documentation_assistant.md': {
     en: readLocale('rag_powered_documentation_assistant.md', 'en'),
+    es: readLocale('rag_powered_documentation_assistant.md', 'es'),
     ru: readLocale('rag_powered_documentation_assistant.md', 'ru'),
     ja: readLocale('rag_powered_documentation_assistant.md', 'ja'),
     fr: readLocale('rag_powered_documentation_assistant.md', 'fr'),
     ko: readLocale('rag_powered_documentation_assistant.md', 'ko'),
     zh: readLocale('rag_powered_documentation_assistant.md', 'zh'),
-    es: readLocale('rag_powered_documentation_assistant.md', 'es'),
     de: readLocale('rag_powered_documentation_assistant.md', 'de'),
     ar: readLocale('rag_powered_documentation_assistant.md', 'ar'),
     it: readLocale('rag_powered_documentation_assistant.md', 'it'),
@@ -541,12 +573,12 @@ export const blogEntry = {
   } as unknown as Record<LocalesValues, Promise<string>>,
   './blog/en/react-i18next_vs_react-intl_vs_intlayer.md': {
     en: readLocale('react-i18next_vs_react-intl_vs_intlayer.md', 'en'),
+    es: readLocale('react-i18next_vs_react-intl_vs_intlayer.md', 'es'),
     ru: readLocale('react-i18next_vs_react-intl_vs_intlayer.md', 'ru'),
     ja: readLocale('react-i18next_vs_react-intl_vs_intlayer.md', 'ja'),
     fr: readLocale('react-i18next_vs_react-intl_vs_intlayer.md', 'fr'),
     ko: readLocale('react-i18next_vs_react-intl_vs_intlayer.md', 'ko'),
     zh: readLocale('react-i18next_vs_react-intl_vs_intlayer.md', 'zh'),
-    es: readLocale('react-i18next_vs_react-intl_vs_intlayer.md', 'es'),
     de: readLocale('react-i18next_vs_react-intl_vs_intlayer.md', 'de'),
     ar: readLocale('react-i18next_vs_react-intl_vs_intlayer.md', 'ar'),
     it: readLocale('react-i18next_vs_react-intl_vs_intlayer.md', 'it'),
@@ -561,12 +593,12 @@ export const blogEntry = {
   } as unknown as Record<LocalesValues, Promise<string>>,
   './blog/en/vue-i18n_vs_intlayer.md': {
     en: readLocale('vue-i18n_vs_intlayer.md', 'en'),
+    es: readLocale('vue-i18n_vs_intlayer.md', 'es'),
     ru: readLocale('vue-i18n_vs_intlayer.md', 'ru'),
     ja: readLocale('vue-i18n_vs_intlayer.md', 'ja'),
     fr: readLocale('vue-i18n_vs_intlayer.md', 'fr'),
     ko: readLocale('vue-i18n_vs_intlayer.md', 'ko'),
     zh: readLocale('vue-i18n_vs_intlayer.md', 'zh'),
-    es: readLocale('vue-i18n_vs_intlayer.md', 'es'),
     de: readLocale('vue-i18n_vs_intlayer.md', 'de'),
     ar: readLocale('vue-i18n_vs_intlayer.md', 'ar'),
     it: readLocale('vue-i18n_vs_intlayer.md', 'it'),
@@ -581,12 +613,12 @@ export const blogEntry = {
   } as unknown as Record<LocalesValues, Promise<string>>,
   './blog/en/what_is_internationalization.md': {
     en: readLocale('what_is_internationalization.md', 'en'),
+    es: readLocale('what_is_internationalization.md', 'es'),
     ru: readLocale('what_is_internationalization.md', 'ru'),
     ja: readLocale('what_is_internationalization.md', 'ja'),
     fr: readLocale('what_is_internationalization.md', 'fr'),
     ko: readLocale('what_is_internationalization.md', 'ko'),
     zh: readLocale('what_is_internationalization.md', 'zh'),
-    es: readLocale('what_is_internationalization.md', 'es'),
     de: readLocale('what_is_internationalization.md', 'de'),
     ar: readLocale('what_is_internationalization.md', 'ar'),
     it: readLocale('what_is_internationalization.md', 'it'),