@intlayer/docs 7.0.0 → 7.0.2-canary.0

package/blog/en/next-i18next_vs_next-intl_vs_intlayer.md

@@ -27,13 +27,7 @@ This is not a full tutorial. It’s a comparison to help you pick.
 
 We focus on **Next.js 13+ App Router** (with **React Server Components**) and evaluate:
 
-1. **Architecture & content organization**
-2. **TypeScript & safety**
-3. **Missing translation handling**
-4. **Routing & middleware**
-5. **Performance & loading behavior**
-6. **Developer experience (DX), tooling & maintenance**
-7. **SEO & large-project scalability**
+<TOC>
 
 > **tl;dr**: All three can localize a Next.js app. If you want **component-scoped content**, **strict TypeScript types**, **build-time missing-key checks**, **tree-shaken dictionaries**, and **first-class App Router + SEO helpers**, **Intlayer** is the most complete, modern choice.
 
@@ -1402,14 +1396,13 @@ export const config = {
 Intlayer provides built-in middleware handling through the `next-intlayer` package configuration.
 
 ```ts fileName="src/middleware.ts"
-import { intlayerMiddleware } from 'next-intlayer/middleware';
+import { intlayerMiddleware } from "next-intlayer/middleware";
 
-export const middleware = intlayerMiddleware()
+export const middleware = intlayerMiddleware();
 
 // applies this middleware only to files in the app directory
 export const config = {
-  matcher:
-    "/((?!api|_next|static|.*\\..*).*)",
+  matcher: "/((?!api|_next|static|.*\\..*).*)",
 };
 ```
 

package/dist/cjs/common.cjs

@@ -27,11 +27,15 @@ const getFile = async (files, docKey, locale = defaultLocale) => {
 };
 const formatMetadata = (docKey, file, locale = defaultLocale) => {
 	const metadata = (0, __intlayer_core.getMarkdownMetadata)(file);
-	const relativeUrl = (0, node_path.join)("/", ...metadata.slugs ?? []);
+	const slugs = (metadata.slugs ?? []).map(String);
+	const keywords = (metadata.keywords ?? []).map(String);
+	const relativeUrl = (0, node_path.join)("/", ...slugs);
 	const slicedDocKey = docKey.slice(1);
 	return {
 		...metadata,
 		docKey,
+		slugs,
+		keywords,
 		githubUrl: `${GITHUB_URL_PREFIX}${slicedDocKey}`.replace("/en/", `/${locale}/`),
 		relativeUrl: (0, __intlayer_core.getLocalizedUrl)(relativeUrl, locale),
 		url: (0, __intlayer_core.getLocalizedUrl)((0, node_path.join)(URL_PREFIX, relativeUrl), locale)

package/dist/cjs/common.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"common.cjs","names":["Locales","fileMetadataArray: FileMetadata[]"],"sources":["../../src/common.ts"],"sourcesContent":["import { join } from 'node:path';\nimport { getLocalizedUrl, getMarkdownMetadata } from '@intlayer/core';\nimport { Locales, type LocalesValues } from '@intlayer/types';\n\nexport const defaultLocale = Locales.ENGLISH;\n\nexport const GITHUB_URL_PREFIX =\n  'https://github.com/aymericzip/intlayer/blob/main/docs';\nexport const URL_PREFIX = 'https://intlayer.org/';\n\nexport const getKeys = <T extends Record<string, any>>(obj: T): (keyof T)[] =>\n  Object.keys(obj) as (keyof T)[];\n\nexport const getFiles = async <\n  F extends Record<`./${string}`, Record<LocalesValues, Promise<string>>>,\n>(\n  files: F,\n  lang: LocalesValues = defaultLocale as LocalesValues\n): Promise<Record<string, string>> => {\n  const filesEntries = await Promise.all(\n    Object.entries(files)\n      .map(([key, value]) => [key, value[lang as LocalesValues]])\n      .map(async ([key, value]) => [key, await value])\n  );\n  const filesResult = Object.fromEntries(filesEntries);\n  return filesResult;\n};\n\nexport const getFile = async <\n  F extends Record<string, Record<LocalesValues, Promise<string>>>,\n>(\n  files: F,\n  docKey: keyof F,\n  locale: LocalesValues = defaultLocale as LocalesValues\n): Promise<string> => {\n  const fileRecord = files[docKey];\n\n  if (!fileRecord) {\n    throw new Error(`File ${docKey as string} not found`);\n  }\n\n  const file = await files[docKey]?.[locale];\n\n  if (!file) {\n    const englishFile = await files[docKey][defaultLocale as LocalesValues];\n\n    if (!englishFile) {\n      throw new Error(`File ${docKey as string} not found`);\n    }\n\n    return englishFile;\n  }\n\n  return file;\n};\n\nexport type FileMetadata = {\n  docKey: string;\n  url: string;\n  relativeUrl: string;\n  githubUrl: string;\n  title: string;\n  slugs: string[];\n  description: string;\n  keywords: string[];\n  updatedAt: string;\n  createdAt: string;\n  author?: string;\n  youtubeVideo?: string;\n  applicationTemplate?: string;\n  history?: {\n    version: string;\n    date: string;\n    changes: string;\n  }[];\n};\n\nexport const formatMetadata = (\n  docKey: string,\n  file: string,\n  locale: LocalesValues = defaultLocale as LocalesValues\n): FileMetadata => {\n  const metadata = getMarkdownMetadata(file);\n  const relativeUrl = join('/', ...(metadata.slugs ?? []));\n\n  const slicedDocKey = docKey.slice(1);\n\n  return {\n    ...metadata,\n    docKey,\n    githubUrl: `${GITHUB_URL_PREFIX}${slicedDocKey}`.replace(\n      '/en/',\n      `/${locale}/`\n    ),\n    relativeUrl: getLocalizedUrl(relativeUrl, locale),\n    url: getLocalizedUrl(join(URL_PREFIX, relativeUrl), locale),\n  } as FileMetadata;\n};\n\nexport const getFileMetadata = async <\n  F extends Record<string, Record<LocalesValues, Promise<string>>>,\n  R extends FileMetadata,\n>(\n  files: F,\n  docKey: keyof F,\n  locale: LocalesValues = defaultLocale as LocalesValues\n): Promise<R> => {\n  const file = await getFile(files, docKey, locale);\n\n  return formatMetadata(docKey as string, file, locale) as R;\n};\n\nexport const getFileMetadataRecord = async <\n  F extends Record<string, Record<LocalesValues, Promise<string>>>,\n>(\n  files: F,\n  locale: LocalesValues = defaultLocale as LocalesValues\n): Promise<Record<keyof F, FileMetadata>> => {\n  const filesEntries = await Promise.all(\n    Object.entries(files).map(async ([key]) => [\n      key,\n      await getFileMetadata(files, key as keyof F, locale),\n    ])\n  );\n  const filesResult = Object.fromEntries(filesEntries);\n  return filesResult;\n};\n\nexport const getFileMetadataBySlug = async <\n  F extends Record<string, Record<LocalesValues, Promise<string>>>,\n>(\n  files: F,\n  slugs: string | string[],\n  locale: LocalesValues = defaultLocale as LocalesValues,\n  strict = false\n) => {\n  const slugsArray = Array.isArray(slugs) ? slugs : [slugs];\n  const filesMetadata = await getFileMetadataRecord(\n    files,\n    defaultLocale as LocalesValues\n  );\n\n  let fileMetadataArray: FileMetadata[] = Object.values(filesMetadata).filter(\n    (fileMetadata) =>\n      slugsArray.every((slug) => fileMetadata.slugs?.includes(slug))\n  );\n\n  if (strict) {\n    fileMetadataArray = fileMetadataArray.filter(\n      (fileMetadata) => fileMetadata.slugs.length === slugsArray.length\n    );\n  }\n\n  if (locale !== defaultLocale) {\n    const localizedFileMetadata = await Promise.all(\n      fileMetadataArray.map(\n        async (fileMetadata) =>\n          await getFileMetadata(files, fileMetadata.docKey, locale)\n      )\n    );\n\n    return localizedFileMetadata;\n  }\n\n  return fileMetadataArray;\n};\n\nexport const getFileBySlug = async <\n  F extends Record<string, Record<LocalesValues, Promise<string>>>,\n>(\n  files: F,\n  slugs: string | string[],\n  locale: LocalesValues = defaultLocale as LocalesValues,\n  strict = false\n) => {\n  const slugsArray = Array.isArray(slugs) ? slugs : [slugs];\n  const filesMetadata = await getFileMetadataRecord(\n    files,\n    defaultLocale as LocalesValues\n  );\n\n  let fileMetadataArray = Object.values(filesMetadata).filter((fileMetadata) =>\n    slugsArray.every((slug) => fileMetadata.slugs?.includes(slug))\n  );\n\n  if (strict) {\n    fileMetadataArray = fileMetadataArray.filter(\n      (fileMetadata) => fileMetadata.slugs.length === slugsArray.length\n    );\n  }\n\n  const fileList = await Promise.all(\n    fileMetadataArray.map(async (fileMetadata) => {\n      const file = await getFile(files, fileMetadata.docKey, locale);\n      return file;\n    })\n  );\n\n  return fileList;\n};\n"],"mappings":"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"}
+{"version":3,"file":"common.cjs","names":["Locales","fileMetadataArray: FileMetadata[]"],"sources":["../../src/common.ts"],"sourcesContent":["import { join } from 'node:path';\nimport { getLocalizedUrl, getMarkdownMetadata } from '@intlayer/core';\nimport { Locales, type LocalesValues } from '@intlayer/types';\n\nexport const defaultLocale = Locales.ENGLISH;\n\nexport const GITHUB_URL_PREFIX =\n  'https://github.com/aymericzip/intlayer/blob/main/docs';\nexport const URL_PREFIX = 'https://intlayer.org/';\n\nexport const getKeys = <T extends Record<string, any>>(obj: T): (keyof T)[] =>\n  Object.keys(obj) as (keyof T)[];\n\nexport const getFiles = async <\n  F extends Record<`./${string}`, Record<LocalesValues, Promise<string>>>,\n>(\n  files: F,\n  lang: LocalesValues = defaultLocale as LocalesValues\n): Promise<Record<string, string>> => {\n  const filesEntries = await Promise.all(\n    Object.entries(files)\n      .map(([key, value]) => [key, value[lang as LocalesValues]])\n      .map(async ([key, value]) => [key, await value])\n  );\n  const filesResult = Object.fromEntries(filesEntries);\n  return filesResult;\n};\n\nexport const getFile = async <\n  F extends Record<string, Record<LocalesValues, Promise<string>>>,\n>(\n  files: F,\n  docKey: keyof F,\n  locale: LocalesValues = defaultLocale as LocalesValues\n): Promise<string> => {\n  const fileRecord = files[docKey];\n\n  if (!fileRecord) {\n    throw new Error(`File ${docKey as string} not found`);\n  }\n\n  const file = await files[docKey]?.[locale];\n\n  if (!file) {\n    const englishFile = await files[docKey][defaultLocale as LocalesValues];\n\n    if (!englishFile) {\n      throw new Error(`File ${docKey as string} not found`);\n    }\n\n    return englishFile;\n  }\n\n  return file;\n};\n\nexport type FileMetadata = {\n  docKey: string;\n  url: string;\n  relativeUrl: string;\n  githubUrl: string;\n  title: string;\n  slugs: string[];\n  description: string;\n  keywords: string[];\n  updatedAt: string;\n  createdAt: string;\n  author?: string;\n  youtubeVideo?: string;\n  applicationTemplate?: string;\n  history?: {\n    version: string;\n    date: string;\n    changes: string;\n  }[];\n};\n\nexport const formatMetadata = (\n  docKey: string,\n  file: string,\n  locale: LocalesValues = defaultLocale as LocalesValues\n): FileMetadata => {\n  const metadata = getMarkdownMetadata(file);\n\n  const slugs = (metadata.slugs ?? []).map(String);\n  const keywords = (metadata.keywords ?? []).map(String);\n\n  const relativeUrl = join('/', ...slugs);\n\n  const slicedDocKey = docKey.slice(1);\n\n  return {\n    ...metadata,\n    docKey,\n    slugs,\n    keywords,\n    githubUrl: `${GITHUB_URL_PREFIX}${slicedDocKey}`.replace(\n      '/en/',\n      `/${locale}/`\n    ),\n    relativeUrl: getLocalizedUrl(relativeUrl, locale),\n    url: getLocalizedUrl(join(URL_PREFIX, relativeUrl), locale),\n  } as FileMetadata;\n};\n\nexport const getFileMetadata = async <\n  F extends Record<string, Record<LocalesValues, Promise<string>>>,\n  R extends FileMetadata,\n>(\n  files: F,\n  docKey: keyof F,\n  locale: LocalesValues = defaultLocale as LocalesValues\n): Promise<R> => {\n  const file = await getFile(files, docKey, locale);\n\n  return formatMetadata(docKey as string, file, locale) as R;\n};\n\nexport const getFileMetadataRecord = async <\n  F extends Record<string, Record<LocalesValues, Promise<string>>>,\n>(\n  files: F,\n  locale: LocalesValues = defaultLocale as LocalesValues\n): Promise<Record<keyof F, FileMetadata>> => {\n  const filesEntries = await Promise.all(\n    Object.entries(files).map(async ([key]) => [\n      key,\n      await getFileMetadata(files, key as keyof F, locale),\n    ])\n  );\n  const filesResult = Object.fromEntries(filesEntries);\n  return filesResult;\n};\n\nexport const getFileMetadataBySlug = async <\n  F extends Record<string, Record<LocalesValues, Promise<string>>>,\n>(\n  files: F,\n  slugs: string | string[],\n  locale: LocalesValues = defaultLocale as LocalesValues,\n  strict = false\n) => {\n  const slugsArray = Array.isArray(slugs) ? slugs : [slugs];\n  const filesMetadata = await getFileMetadataRecord(\n    files,\n    defaultLocale as LocalesValues\n  );\n\n  let fileMetadataArray: FileMetadata[] = Object.values(filesMetadata).filter(\n    (fileMetadata) =>\n      slugsArray.every((slug) => fileMetadata.slugs?.includes(slug))\n  );\n\n  if (strict) {\n    fileMetadataArray = fileMetadataArray.filter(\n      (fileMetadata) => fileMetadata.slugs.length === slugsArray.length\n    );\n  }\n\n  if (locale !== defaultLocale) {\n    const localizedFileMetadata = await Promise.all(\n      fileMetadataArray.map(\n        async (fileMetadata) =>\n          await getFileMetadata(files, fileMetadata.docKey, locale)\n      )\n    );\n\n    return localizedFileMetadata;\n  }\n\n  return fileMetadataArray;\n};\n\nexport const getFileBySlug = async <\n  F extends Record<string, Record<LocalesValues, Promise<string>>>,\n>(\n  files: F,\n  slugs: string | string[],\n  locale: LocalesValues = defaultLocale as LocalesValues,\n  strict = false\n) => {\n  const slugsArray = Array.isArray(slugs) ? slugs : [slugs];\n  const filesMetadata = await getFileMetadataRecord(\n    files,\n    defaultLocale as LocalesValues\n  );\n\n  let fileMetadataArray = Object.values(filesMetadata).filter((fileMetadata) =>\n    slugsArray.every((slug) => fileMetadata.slugs?.includes(slug))\n  );\n\n  if (strict) {\n    fileMetadataArray = fileMetadataArray.filter(\n      (fileMetadata) => fileMetadata.slugs.length === slugsArray.length\n    );\n  }\n\n  const fileList = await Promise.all(\n    fileMetadataArray.map(async (fileMetadata) => {\n      const file = await getFile(files, fileMetadata.docKey, locale);\n      return file;\n    })\n  );\n\n  return fileList;\n};\n"],"mappings":";;;;;;;;;AAIA,MAAa,gBAAgBA,yBAAQ;AAErC,MAAa,oBACX;AACF,MAAa,aAAa;AAE1B,MAAa,WAA0C,QACrD,OAAO,KAAK,IAAI;AAElB,MAAa,WAAW,OAGtB,OACA,OAAsB,kBACc;CACpC,MAAM,eAAe,MAAM,QAAQ,IACjC,OAAO,QAAQ,MAAM,CAClB,KAAK,CAAC,KAAK,WAAW,CAAC,KAAK,MAAM,MAAuB,CAAC,CAC1D,IAAI,OAAO,CAAC,KAAK,WAAW,CAAC,KAAK,MAAM,MAAM,CAAC,CACnD;AAED,QADoB,OAAO,YAAY,aAAa;;AAItD,MAAa,UAAU,OAGrB,OACA,QACA,SAAwB,kBACJ;AAGpB,KAAI,CAFe,MAAM,QAGvB,OAAM,IAAI,MAAM,QAAQ,OAAiB,YAAY;CAGvD,MAAM,OAAO,MAAM,MAAM,UAAU;AAEnC,KAAI,CAAC,MAAM;EACT,MAAM,cAAc,MAAM,MAAM,QAAQ;AAExC,MAAI,CAAC,YACH,OAAM,IAAI,MAAM,QAAQ,OAAiB,YAAY;AAGvD,SAAO;;AAGT,QAAO;;AAwBT,MAAa,kBACX,QACA,MACA,SAAwB,kBACP;CACjB,MAAM,oDAA+B,KAAK;CAE1C,MAAM,SAAS,SAAS,SAAS,EAAE,EAAE,IAAI,OAAO;CAChD,MAAM,YAAY,SAAS,YAAY,EAAE,EAAE,IAAI,OAAO;CAEtD,MAAM,kCAAmB,KAAK,GAAG,MAAM;CAEvC,MAAM,eAAe,OAAO,MAAM,EAAE;AAEpC,QAAO;EACL,GAAG;EACH;EACA;EACA;EACA,WAAW,GAAG,oBAAoB,eAAe,QAC/C,QACA,IAAI,OAAO,GACZ;EACD,kDAA6B,aAAa,OAAO;EACjD,8DAA0B,YAAY,YAAY,EAAE,OAAO;EAC5D;;AAGH,MAAa,kBAAkB,OAI7B,OACA,QACA,SAAwB,kBACT;AAGf,QAAO,eAAe,QAFT,MAAM,QAAQ,OAAO,QAAQ,OAAO,EAEH,OAAO;;AAGvD,MAAa,wBAAwB,OAGnC,OACA,SAAwB,kBACmB;CAC3C,MAAM,eAAe,MAAM,QAAQ,IACjC,OAAO,QAAQ,MAAM,CAAC,IAAI,OAAO,CAAC,SAAS,CACzC,KACA,MAAM,gBAAgB,OAAO,KAAgB,OAAO,CACrD,CAAC,CACH;AAED,QADoB,OAAO,YAAY,aAAa;;AAItD,MAAa,wBAAwB,OAGnC,OACA,OACA,SAAwB,eACxB,SAAS,UACN;CACH,MAAM,aAAa,MAAM,QAAQ,MAAM,GAAG,QAAQ,CAAC,MAAM;CACzD,MAAM,gBAAgB,MAAM,sBAC1B,OACA,cACD;CAED,IAAIC,oBAAoC,OAAO,OAAO,cAAc,CAAC,QAClE,iBACC,WAAW,OAAO,SAAS,aAAa,OAAO,SAAS,KAAK,CAAC,CACjE;AAED,KAAI,OACF,qBAAoB,kBAAkB,QACnC,iBAAiB,aAAa,MAAM,WAAW,WAAW,OAC5D;AAGH,KAAI,WAAW,cAQb,QAP8B,MAAM,QAAQ,IAC1C,kBAAkB,IAChB,OAAO,iBACL,MAAM,gBAAgB,OAAO,aAAa,QAAQ,OAAO,CAC5D,CACF;AAKH,QAAO;;AAGT,MAAa,gBAAgB,OAG3B,OACA,OACA,SAAwB,eACxB,SAAS,UACN;CACH,MAAM,aAAa,MAAM,QAAQ,MAAM,GAAG,QAAQ,CAAC,MAAM;CACzD,MAAM,gBAAgB,MAAM,sBAC1B,OACA,cACD;CAED,IAAI,oBAAoB,OAAO,OAAO,cAAc,CAAC,QAAQ,iBAC3D,WAAW,OAAO,SAAS,aAAa,OAAO,SAAS,KAAK,CAAC,CAC/D;AAED,KAAI,OACF,qBAAoB,kBAAkB,QACnC,iBAAiB,aAAa,MAAM,WAAW,WAAW,OAC5D;AAUH,QAPiB,MAAM,QAAQ,IAC7B,kBAAkB,IAAI,OAAO,iBAAiB;AAE5C,SADa,MAAM,QAAQ,OAAO,aAAa,QAAQ,OAAO;GAE9D,CACH"}

package/dist/esm/common.mjs

@@ -23,11 +23,15 @@ const getFile = async (files, docKey, locale = defaultLocale) => {
 };
 const formatMetadata = (docKey, file, locale = defaultLocale) => {
 	const metadata = getMarkdownMetadata(file);
-	const relativeUrl = join("/", ...metadata.slugs ?? []);
+	const slugs = (metadata.slugs ?? []).map(String);
+	const keywords = (metadata.keywords ?? []).map(String);
+	const relativeUrl = join("/", ...slugs);
 	const slicedDocKey = docKey.slice(1);
 	return {
 		...metadata,
 		docKey,
+		slugs,
+		keywords,
 		githubUrl: `${GITHUB_URL_PREFIX}${slicedDocKey}`.replace("/en/", `/${locale}/`),
 		relativeUrl: getLocalizedUrl(relativeUrl, locale),
 		url: getLocalizedUrl(join(URL_PREFIX, relativeUrl), locale)

package/dist/esm/common.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"common.mjs","names":["fileMetadataArray: FileMetadata[]"],"sources":["../../src/common.ts"],"sourcesContent":["import { join } from 'node:path';\nimport { getLocalizedUrl, getMarkdownMetadata } from '@intlayer/core';\nimport { Locales, type LocalesValues } from '@intlayer/types';\n\nexport const defaultLocale = Locales.ENGLISH;\n\nexport const GITHUB_URL_PREFIX =\n  'https://github.com/aymericzip/intlayer/blob/main/docs';\nexport const URL_PREFIX = 'https://intlayer.org/';\n\nexport const getKeys = <T extends Record<string, any>>(obj: T): (keyof T)[] =>\n  Object.keys(obj) as (keyof T)[];\n\nexport const getFiles = async <\n  F extends Record<`./${string}`, Record<LocalesValues, Promise<string>>>,\n>(\n  files: F,\n  lang: LocalesValues = defaultLocale as LocalesValues\n): Promise<Record<string, string>> => {\n  const filesEntries = await Promise.all(\n    Object.entries(files)\n      .map(([key, value]) => [key, value[lang as LocalesValues]])\n      .map(async ([key, value]) => [key, await value])\n  );\n  const filesResult = Object.fromEntries(filesEntries);\n  return filesResult;\n};\n\nexport const getFile = async <\n  F extends Record<string, Record<LocalesValues, Promise<string>>>,\n>(\n  files: F,\n  docKey: keyof F,\n  locale: LocalesValues = defaultLocale as LocalesValues\n): Promise<string> => {\n  const fileRecord = files[docKey];\n\n  if (!fileRecord) {\n    throw new Error(`File ${docKey as string} not found`);\n  }\n\n  const file = await files[docKey]?.[locale];\n\n  if (!file) {\n    const englishFile = await files[docKey][defaultLocale as LocalesValues];\n\n    if (!englishFile) {\n      throw new Error(`File ${docKey as string} not found`);\n    }\n\n    return englishFile;\n  }\n\n  return file;\n};\n\nexport type FileMetadata = {\n  docKey: string;\n  url: string;\n  relativeUrl: string;\n  githubUrl: string;\n  title: string;\n  slugs: string[];\n  description: string;\n  keywords: string[];\n  updatedAt: string;\n  createdAt: string;\n  author?: string;\n  youtubeVideo?: string;\n  applicationTemplate?: string;\n  history?: {\n    version: string;\n    date: string;\n    changes: string;\n  }[];\n};\n\nexport const formatMetadata = (\n  docKey: string,\n  file: string,\n  locale: LocalesValues = defaultLocale as LocalesValues\n): FileMetadata => {\n  const metadata = getMarkdownMetadata(file);\n  const relativeUrl = join('/', ...(metadata.slugs ?? []));\n\n  const slicedDocKey = docKey.slice(1);\n\n  return {\n    ...metadata,\n    docKey,\n    githubUrl: `${GITHUB_URL_PREFIX}${slicedDocKey}`.replace(\n      '/en/',\n      `/${locale}/`\n    ),\n    relativeUrl: getLocalizedUrl(relativeUrl, locale),\n    url: getLocalizedUrl(join(URL_PREFIX, relativeUrl), locale),\n  } as FileMetadata;\n};\n\nexport const getFileMetadata = async <\n  F extends Record<string, Record<LocalesValues, Promise<string>>>,\n  R extends FileMetadata,\n>(\n  files: F,\n  docKey: keyof F,\n  locale: LocalesValues = defaultLocale as LocalesValues\n): Promise<R> => {\n  const file = await getFile(files, docKey, locale);\n\n  return formatMetadata(docKey as string, file, locale) as R;\n};\n\nexport const getFileMetadataRecord = async <\n  F extends Record<string, Record<LocalesValues, Promise<string>>>,\n>(\n  files: F,\n  locale: LocalesValues = defaultLocale as LocalesValues\n): Promise<Record<keyof F, FileMetadata>> => {\n  const filesEntries = await Promise.all(\n    Object.entries(files).map(async ([key]) => [\n      key,\n      await getFileMetadata(files, key as keyof F, locale),\n    ])\n  );\n  const filesResult = Object.fromEntries(filesEntries);\n  return filesResult;\n};\n\nexport const getFileMetadataBySlug = async <\n  F extends Record<string, Record<LocalesValues, Promise<string>>>,\n>(\n  files: F,\n  slugs: string | string[],\n  locale: LocalesValues = defaultLocale as LocalesValues,\n  strict = false\n) => {\n  const slugsArray = Array.isArray(slugs) ? slugs : [slugs];\n  const filesMetadata = await getFileMetadataRecord(\n    files,\n    defaultLocale as LocalesValues\n  );\n\n  let fileMetadataArray: FileMetadata[] = Object.values(filesMetadata).filter(\n    (fileMetadata) =>\n      slugsArray.every((slug) => fileMetadata.slugs?.includes(slug))\n  );\n\n  if (strict) {\n    fileMetadataArray = fileMetadataArray.filter(\n      (fileMetadata) => fileMetadata.slugs.length === slugsArray.length\n    );\n  }\n\n  if (locale !== defaultLocale) {\n    const localizedFileMetadata = await Promise.all(\n      fileMetadataArray.map(\n        async (fileMetadata) =>\n          await getFileMetadata(files, fileMetadata.docKey, locale)\n      )\n    );\n\n    return localizedFileMetadata;\n  }\n\n  return fileMetadataArray;\n};\n\nexport const getFileBySlug = async <\n  F extends Record<string, Record<LocalesValues, Promise<string>>>,\n>(\n  files: F,\n  slugs: string | string[],\n  locale: LocalesValues = defaultLocale as LocalesValues,\n  strict = false\n) => {\n  const slugsArray = Array.isArray(slugs) ? slugs : [slugs];\n  const filesMetadata = await getFileMetadataRecord(\n    files,\n    defaultLocale as LocalesValues\n  );\n\n  let fileMetadataArray = Object.values(filesMetadata).filter((fileMetadata) =>\n    slugsArray.every((slug) => fileMetadata.slugs?.includes(slug))\n  );\n\n  if (strict) {\n    fileMetadataArray = fileMetadataArray.filter(\n      (fileMetadata) => fileMetadata.slugs.length === slugsArray.length\n    );\n  }\n\n  const fileList = await Promise.all(\n    fileMetadataArray.map(async (fileMetadata) => {\n      const file = await getFile(files, fileMetadata.docKey, locale);\n      return file;\n    })\n  );\n\n  return fileList;\n};\n"],"mappings":"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"}
+{"version":3,"file":"common.mjs","names":["fileMetadataArray: FileMetadata[]"],"sources":["../../src/common.ts"],"sourcesContent":["import { join } from 'node:path';\nimport { getLocalizedUrl, getMarkdownMetadata } from '@intlayer/core';\nimport { Locales, type LocalesValues } from '@intlayer/types';\n\nexport const defaultLocale = Locales.ENGLISH;\n\nexport const GITHUB_URL_PREFIX =\n  'https://github.com/aymericzip/intlayer/blob/main/docs';\nexport const URL_PREFIX = 'https://intlayer.org/';\n\nexport const getKeys = <T extends Record<string, any>>(obj: T): (keyof T)[] =>\n  Object.keys(obj) as (keyof T)[];\n\nexport const getFiles = async <\n  F extends Record<`./${string}`, Record<LocalesValues, Promise<string>>>,\n>(\n  files: F,\n  lang: LocalesValues = defaultLocale as LocalesValues\n): Promise<Record<string, string>> => {\n  const filesEntries = await Promise.all(\n    Object.entries(files)\n      .map(([key, value]) => [key, value[lang as LocalesValues]])\n      .map(async ([key, value]) => [key, await value])\n  );\n  const filesResult = Object.fromEntries(filesEntries);\n  return filesResult;\n};\n\nexport const getFile = async <\n  F extends Record<string, Record<LocalesValues, Promise<string>>>,\n>(\n  files: F,\n  docKey: keyof F,\n  locale: LocalesValues = defaultLocale as LocalesValues\n): Promise<string> => {\n  const fileRecord = files[docKey];\n\n  if (!fileRecord) {\n    throw new Error(`File ${docKey as string} not found`);\n  }\n\n  const file = await files[docKey]?.[locale];\n\n  if (!file) {\n    const englishFile = await files[docKey][defaultLocale as LocalesValues];\n\n    if (!englishFile) {\n      throw new Error(`File ${docKey as string} not found`);\n    }\n\n    return englishFile;\n  }\n\n  return file;\n};\n\nexport type FileMetadata = {\n  docKey: string;\n  url: string;\n  relativeUrl: string;\n  githubUrl: string;\n  title: string;\n  slugs: string[];\n  description: string;\n  keywords: string[];\n  updatedAt: string;\n  createdAt: string;\n  author?: string;\n  youtubeVideo?: string;\n  applicationTemplate?: string;\n  history?: {\n    version: string;\n    date: string;\n    changes: string;\n  }[];\n};\n\nexport const formatMetadata = (\n  docKey: string,\n  file: string,\n  locale: LocalesValues = defaultLocale as LocalesValues\n): FileMetadata => {\n  const metadata = getMarkdownMetadata(file);\n\n  const slugs = (metadata.slugs ?? []).map(String);\n  const keywords = (metadata.keywords ?? []).map(String);\n\n  const relativeUrl = join('/', ...slugs);\n\n  const slicedDocKey = docKey.slice(1);\n\n  return {\n    ...metadata,\n    docKey,\n    slugs,\n    keywords,\n    githubUrl: `${GITHUB_URL_PREFIX}${slicedDocKey}`.replace(\n      '/en/',\n      `/${locale}/`\n    ),\n    relativeUrl: getLocalizedUrl(relativeUrl, locale),\n    url: getLocalizedUrl(join(URL_PREFIX, relativeUrl), locale),\n  } as FileMetadata;\n};\n\nexport const getFileMetadata = async <\n  F extends Record<string, Record<LocalesValues, Promise<string>>>,\n  R extends FileMetadata,\n>(\n  files: F,\n  docKey: keyof F,\n  locale: LocalesValues = defaultLocale as LocalesValues\n): Promise<R> => {\n  const file = await getFile(files, docKey, locale);\n\n  return formatMetadata(docKey as string, file, locale) as R;\n};\n\nexport const getFileMetadataRecord = async <\n  F extends Record<string, Record<LocalesValues, Promise<string>>>,\n>(\n  files: F,\n  locale: LocalesValues = defaultLocale as LocalesValues\n): Promise<Record<keyof F, FileMetadata>> => {\n  const filesEntries = await Promise.all(\n    Object.entries(files).map(async ([key]) => [\n      key,\n      await getFileMetadata(files, key as keyof F, locale),\n    ])\n  );\n  const filesResult = Object.fromEntries(filesEntries);\n  return filesResult;\n};\n\nexport const getFileMetadataBySlug = async <\n  F extends Record<string, Record<LocalesValues, Promise<string>>>,\n>(\n  files: F,\n  slugs: string | string[],\n  locale: LocalesValues = defaultLocale as LocalesValues,\n  strict = false\n) => {\n  const slugsArray = Array.isArray(slugs) ? slugs : [slugs];\n  const filesMetadata = await getFileMetadataRecord(\n    files,\n    defaultLocale as LocalesValues\n  );\n\n  let fileMetadataArray: FileMetadata[] = Object.values(filesMetadata).filter(\n    (fileMetadata) =>\n      slugsArray.every((slug) => fileMetadata.slugs?.includes(slug))\n  );\n\n  if (strict) {\n    fileMetadataArray = fileMetadataArray.filter(\n      (fileMetadata) => fileMetadata.slugs.length === slugsArray.length\n    );\n  }\n\n  if (locale !== defaultLocale) {\n    const localizedFileMetadata = await Promise.all(\n      fileMetadataArray.map(\n        async (fileMetadata) =>\n          await getFileMetadata(files, fileMetadata.docKey, locale)\n      )\n    );\n\n    return localizedFileMetadata;\n  }\n\n  return fileMetadataArray;\n};\n\nexport const getFileBySlug = async <\n  F extends Record<string, Record<LocalesValues, Promise<string>>>,\n>(\n  files: F,\n  slugs: string | string[],\n  locale: LocalesValues = defaultLocale as LocalesValues,\n  strict = false\n) => {\n  const slugsArray = Array.isArray(slugs) ? slugs : [slugs];\n  const filesMetadata = await getFileMetadataRecord(\n    files,\n    defaultLocale as LocalesValues\n  );\n\n  let fileMetadataArray = Object.values(filesMetadata).filter((fileMetadata) =>\n    slugsArray.every((slug) => fileMetadata.slugs?.includes(slug))\n  );\n\n  if (strict) {\n    fileMetadataArray = fileMetadataArray.filter(\n      (fileMetadata) => fileMetadata.slugs.length === slugsArray.length\n    );\n  }\n\n  const fileList = await Promise.all(\n    fileMetadataArray.map(async (fileMetadata) => {\n      const file = await getFile(files, fileMetadata.docKey, locale);\n      return file;\n    })\n  );\n\n  return fileList;\n};\n"],"mappings":"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"}

package/dist/types/common.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"common.d.ts","names":[],"sources":["../../src/common.ts"],"sourcesContent":[],"mappings":"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"}
+{"version":3,"file":"common.d.ts","names":[],"sources":["../../src/common.ts"],"sourcesContent":[],"mappings":"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"}

package/docs/ar/intlayer_with_nextjs_15.md

@@ -771,15 +771,17 @@ export const generateMetadata = async ({
    * ```
    */
   const multilingualUrls = getMultilingualUrls("/");
+  const localizedUrl =
+    multilingualUrls[locale as keyof typeof multilingualUrls];
 
   return {
     ...metadata,
     alternates: {
-      canonical: multilingualUrls[locale as keyof typeof multilingualUrls],
+      canonical: localizedUrl,
       languages: { ...multilingualUrls, "x-default": "/" },
     },
     openGraph: {
-      url: multilingualUrls[locale],
+      url: localizedUrl,
     },
   };
 };
@@ -811,15 +813,16 @@ export const generateMetadata = async ({ params }) => {
    * ```
    */
   const multilingualUrls = getMultilingualUrls("/");
+  const localizedUrl = multilingualUrls[locale];
 
   return {
     ...metadata,
     alternates: {
-      canonical: multilingualUrls[locale],
+      canonical: localizedUrl,
       languages: { ...multilingualUrls, "x-default": "/" },
     },
     openGraph: {
-      url: multilingualUrls[locale],
+      url: localizedUrl,
     },
   };
 };
@@ -851,15 +854,16 @@ const generateMetadata = async ({ params }) => {
    * ```
    */
   const multilingualUrls = getMultilingualUrls("/");
+  const localizedUrl = multilingualUrls[locale];
 
   return {
     ...metadata,
     alternates: {
-      canonical: multilingualUrls[locale],
+      canonical: localizedUrl,
       languages: { ...multilingualUrls, "x-default": "/" },
     },
     openGraph: {
-      url: multilingualUrls[locale],
+      url: localizedUrl,
     },
   };
 };

package/docs/ar/intlayer_with_nextjs_16.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2025-10-25
-updatedAt: 2025-10-25
+updatedAt: 2025-10-26
 title: كيفية ترجمة تطبيق Next.js 16 الخاص بك – دليل i18n لعام 2025
 description: اكتشف كيفية جعل موقع Next.js 16 الخاص بك متعدد اللغات. اتبع الوثائق لتدويل (i18n) وترجمته.
 keywords:
@@ -843,15 +843,17 @@ export const generateMetadata = async ({
    * ```
    */
   const multilingualUrls = getMultilingualUrls("/");
+  const localizedUrl =
+    multilingualUrls[locale as keyof typeof multilingualUrls];
 
   return {
     ...metadata,
     alternates: {
-      canonical: multilingualUrls[locale as keyof typeof multilingualUrls],
+      canonical: localizedUrl,
       languages: { ...multilingualUrls, "x-default": "/" },
     },
     openGraph: {
-      url: multilingualUrls[locale],
+      url: localizedUrl,
     },
   };
 };
@@ -883,15 +885,16 @@ export const generateMetadata = async ({ params }) => {
    * ```
    */
   const multilingualUrls = getMultilingualUrls("/");
+  const localizedUrl = multilingualUrls[locale];
 
   return {
     ...metadata,
     alternates: {
-      canonical: multilingualUrls[locale],
+      canonical: localizedUrl,
       languages: { ...multilingualUrls, "x-default": "/" },
     },
     openGraph: {
-      url: multilingualUrls[locale],
+      url: localizedUrl,
     },
   };
 };
@@ -923,15 +926,16 @@ const generateMetadata = async ({ params }) => {
    * ```
    */
   const multilingualUrls = getMultilingualUrls("/");
+  const localizedUrl = multilingualUrls[locale];
 
   return {
     ...metadata,
     alternates: {
-      canonical: multilingualUrls[locale],
+      canonical: localizedUrl,
       languages: { ...multilingualUrls, "x-default": "/" },
     },
     openGraph: {
-      url: multilingualUrls[locale],
+      url: localizedUrl,
     },
   };
 };

package/docs/de/intlayer_with_nextjs_15.md

@@ -774,15 +774,17 @@ export const generateMetadata = async ({
    * ```
    */
   const multilingualUrls = getMultilingualUrls("/");
+  const localizedUrl =
+    multilingualUrls[locale as keyof typeof multilingualUrls];
 
   return {
     ...metadata,
     alternates: {
-      canonical: multilingualUrls[locale as keyof typeof multilingualUrls],
+      canonical: localizedUrl,
       languages: { ...multilingualUrls, "x-default": "/" },
     },
     openGraph: {
-      url: multilingualUrls[locale],
+      url: localizedUrl,
     },
   };
 };
@@ -814,15 +816,16 @@ export const generateMetadata = async ({ params }) => {
    * ```
    */
   const multilingualUrls = getMultilingualUrls("/");
+  const localizedUrl = multilingualUrls[locale];
 
   return {
     ...metadata,
     alternates: {
-      canonical: multilingualUrls[locale],
+      canonical: localizedUrl,
       languages: { ...multilingualUrls, "x-default": "/" },
     },
     openGraph: {
-      url: multilingualUrls[locale],
+      url: localizedUrl,
     },
   };
 };
@@ -854,15 +857,16 @@ const generateMetadata = async ({ params }) => {
    * ```
    */
   const multilingualUrls = getMultilingualUrls("/");
+  const localizedUrl = multilingualUrls[locale];
 
   return {
     ...metadata,
     alternates: {
-      canonical: multilingualUrls[locale],
+      canonical: localizedUrl,
       languages: { ...multilingualUrls, "x-default": "/" },
     },
     openGraph: {
-      url: multilingualUrls[locale],
+      url: localizedUrl,
     },
   };
 };

package/docs/de/intlayer_with_nextjs_16.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2025-10-25
-updatedAt: 2025-10-25
+updatedAt: 2025-10-26
 title: Wie Sie Ihre Next.js 16 App übersetzen – i18n Leitfaden 2025
 description: Entdecken Sie, wie Sie Ihre Next.js 16 Website mehrsprachig machen. Folgen Sie der Dokumentation, um sie zu internationalisieren (i18n) und zu übersetzen.
 keywords:
@@ -872,15 +872,17 @@ export const generateMetadata = async ({
    * ```
    */
   const multilingualUrls = getMultilingualUrls("/");
+  const localizedUrl =
+    multilingualUrls[locale as keyof typeof multilingualUrls];
 
   return {
     ...metadata,
     alternates: {
-      canonical: multilingualUrls[locale as keyof typeof multilingualUrls],
+      canonical: localizedUrl,
       languages: { ...multilingualUrls, "x-default": "/" },
     },
     openGraph: {
-      url: multilingualUrls[locale],
+      url: localizedUrl,
     },
   };
 };
@@ -912,15 +914,16 @@ export const generateMetadata = async ({ params }) => {
    * ```
    */
   const multilingualUrls = getMultilingualUrls("/");
+  const localizedUrl = multilingualUrls[locale];
 
   return {
     ...metadata,
     alternates: {
-      canonical: multilingualUrls[locale],
+      canonical: localizedUrl,
       languages: { ...multilingualUrls, "x-default": "/" },
     },
     openGraph: {
-      url: multilingualUrls[locale],
+      url: localizedUrl,
     },
   };
 };
@@ -952,15 +955,16 @@ const generateMetadata = async ({ params }) => {
    * ```
    */
   const multilingualUrls = getMultilingualUrls("/");
+  const localizedUrl = multilingualUrls[locale];
 
   return {
     ...metadata,
     alternates: {
-      canonical: multilingualUrls[locale],
+      canonical: localizedUrl,
       languages: { ...multilingualUrls, "x-default": "/" },
     },
     openGraph: {
-      url: multilingualUrls[locale],
+      url: localizedUrl,
     },
   };
 };

package/docs/en/CI_CD.md

@@ -25,6 +25,10 @@ history:
 
 Intlayer allows the automatic generation of translations for your content declaration files. There are multiple ways to achieve this depending on your workflow.
 
+## Table of Contents
+
+<TOC>
+
 ## Using the CMS
 
 With Intlayer, you can adopt a workflow where only a single locale is declared locally, while all translations are managed remotely through the CMS. This allows content and translations to be completely detached from the codebase, offering more flexibility for content editors and enabling Live Sync (no need to rebuild the application to apply changes).

package/docs/en/configuration.md

@@ -57,6 +57,12 @@ Intlayer configuration files allow customization of various aspects of the plugi
 
 ---
 
+## Table of Contents
+
+<TOC>
+
+---
+
 ## Configuration File Support
 
 Intlayer accepts JSON, JS, MJS, and TS configuration file formats:
@@ -316,51 +322,32 @@ Settings that control routing behavior, including URL structure, locale storage,
   - _Note_: This setting does not impact cookie or locale storage management.
 
 - **storage**:
-  - _Type_: `false | 'cookie' | 'localStorage' | 'sessionStorage' | CookiesAttributes | LocaleStorageAttributes | Array`
+  - _Type_: `false | 'cookie' | 'localStorage' | 'sessionStorage' | 'header' | CookiesAttributes | StorageAttributes | Array`
   - _Default_: `'localStorage'`
   - _Description_: Configuration for storing the locale in the client.
-  - _Examples_:
-
-    ```typescript
-    // Disable storage
-    storage: false
-
-    // Simple storage types
-    storage: 'cookie'
-    storage: 'localStorage'
-    storage: 'sessionStorage'
 
-    // Cookie with custom attributes
-    storage: {
-      type: 'cookie',
-      name: 'custom-locale',
-      domain: '.example.com',
-      secure: true,
-      sameSite: 'strict'
-    }
-
-    // localStorage with custom key
-    storage: {
-      type: 'localStorage',
-      name: 'custom-locale'
-    }
-
-    // Multiple storage types
-    storage: ['cookie', 'localStorage']
-    ```
-
-  - _Note_:
-    - If `false`, the locale will not be stored by the middleware
-    - Check GDPR compliance for cookies. See https://gdpr.eu/cookies/
-    - Recommendation: Configure both localStorage and cookies for GDPR compliance
-    - Disable cookie storage by default on the useLocale hook until user consent
-
-- **headerName**:
-  - _Type_: `string`
-  - _Default_: `'x-intlayer-locale'`
-  - _Description_: The name of the HTTP header used to determine the locale.
-  - _Example_: `'x-custom-locale'`
-  - _Note_: This is useful for API-based locale determination.
+  - **cookie**:
+    - _Description_: Stores data in cookies, small pieces of data stored on the client's browser, accessible on both client and server side.
+    - _Note_: For GDPR compliant storage, ensure proper user consent before usage.
+    - _Note_: Cookies parameters are customizable if set as CookiesAttributes (`{ type: 'cookie', name: 'custom-locale', secure: true, httpOnly: false }`).
+
+  - **localStorage**:
+    - _Description_: Stores data in the browser without expiration dates, allowing for data persistence across sessions, accessible only on the client side.
+    - _Note_: Ideal for storing long-term data but mindful of the privacy and security implications due to non-expiring nature unless explicitly cleared.
+    - _Note_: Locale storage is only accessible on the client side, the intlayer proxy will not be able to access it.
+    - _Note_: Locale storage parameters are customizable if set as StorageAttributes (`{ type: 'localStorage', name: 'custom-locale' }`).
+
+  - **sessionStorage**:
+    - _Description_: Stores data for the duration of a page session, meaning it gets cleared once the tab or window is closed, accessible only on the client side.
+    - _Note_: Suitable for temporary data storage for each session.
+    - _Note_: Locale storage is only accessible on the client side, the intlayer proxy will not be able to access it.
+    - _Note_: Locale storage parameters are customizable if set as StorageAttributes (`{ type: 'sessionStorage', name: 'custom-locale' }`).
+
+  - **header**:
+    - _Description_: Utilizes HTTP headers to store or transmit locale data, suitable for server-side language determination.
+    - _Note_: Useful in API calls for maintaining consistent language settings across requests.
+    - _Note_: Header is only accessible on the server side, the client side will not be able to access it.
+    - _Note_: Header name is customizable if set as StorageAttributes (`{ type: 'header', name: 'custom-locale' }`).
 
 - **basePath**:
   - _Type_: `string`

package/docs/en/formatters.md

@@ -44,6 +44,10 @@ history:
 
 # Intlayer Formatters
 
+## Table of Contents
+
+<TOC>
+
 ## Overview
 
 Intlayer provides a set of lightweight helpers built on top of the native `Intl` APIs, plus a cached `Intl` wrapper to avoid repeatedly constructing heavy formatters. These utilities are fully locale-aware and can be used from the main `intlayer` package.

package/docs/en/how_works_intlayer.md

@@ -21,6 +21,10 @@ history:
 
 # How Intlayer Works
 
+## Table of Contents
+
+<TOC>
+
 ## Overview
 
 The main idea behind Intlayer is to adopt a per-component content management. So the idea behind Intlayer is to allow you to declare your content anywhere in your codebase, as in the same directory as your component.

package/docs/en/index.md

@@ -91,6 +91,7 @@ Organize your multilingual content close to your code to keep everything consist
 
 We’ve built Intlayer with flexibility in mind, offering seamless integration across popular frameworks and build tools:
 
+- **[Intlayer with Next.js 16](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/intlayer_with_nextjs_16.md)**
 - **[Intlayer with Next.js 15](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/intlayer_with_nextjs_15.md)**
 - **[Intlayer with Next.js 14 (App Router)](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/intlayer_with_nextjs_14.md)**
 - **[Intlayer with Next.js Page Router](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/intlayer_with_nextjs_page_router.md)**

package/docs/en/intlayer_CMS.md

@@ -39,6 +39,12 @@ For that, Intlayer introduce the concept of 'distant dictionaries'.
 
 ![Intlayer CMS Interface](https://github.com/aymericzip/intlayer/blob/main/docs/assets/CMS.png)
 
+## Table of Contents
+
+<TOC>
+
+---
+
 ## Understanding distant dictionaries
 
 Intlayer make a difference between 'local' and 'remote' dictionaries.

package/docs/en/intlayer_cli.md

@@ -48,6 +48,14 @@ history:
 
 # Intlayer CLI
 
+---
+
+## Table of Contents
+
+<TOC>
+
+---
+
 ## Install Package
 
 Install the necessary packages using npm:

package/docs/en/intlayer_with_nextjs_14.md

@@ -38,6 +38,10 @@ history:
 
 See [Application Template](https://github.com/aymericzip/intlayer-next-14-template) on GitHub.
 
+## Table of Contents
+
+<TOC>
+
 ## What is Intlayer?
 
 **Intlayer** is an innovative, open-source internationalization (i18n) library designed to simplify multilingual support in modern web applications. Intlayer seamlessly integrates with the latest **Next.js 14** framework, including its powerful **App Router**. It is optimized to work with **Server Components** for efficient rendering and is fully compatible with [**Turbopack**](https://nextjs.org/docs/architecture/turbopack) (from Next.js >= 15).
@@ -767,15 +771,17 @@ export const generateMetadata = ({
    * ```
    */
   const multilingualUrls = getMultilingualUrls("/");
+  const localizedUrl =
+    multilingualUrls[locale as keyof typeof multilingualUrls];
 
   return {
     ...metadata,
     alternates: {
-      canonical: multilingualUrls[locale as keyof typeof multilingualUrls],
+      canonical: localizedUrl,
       languages: { ...multilingualUrls, "x-default": "/" },
     },
     openGraph: {
-      url: multilingualUrls[locale],
+      url: localizedUrl,
     },
   };
 };
@@ -805,15 +811,16 @@ export const generateMetadata = ({ params: { locale } }) => {
    * ```
    */
   const multilingualUrls = getMultilingualUrls("/");
+  const localizedUrl = multilingualUrls[locale];
 
   return {
     ...metadata,
     alternates: {
-      canonical: multilingualUrls[locale],
+      canonical: localizedUrl,
       languages: { ...multilingualUrls, "x-default": "/" },
     },
     openGraph: {
-      url: multilingualUrls[locale],
+      url: localizedUrl,
     },
   };
 };
@@ -843,15 +850,16 @@ const generateMetadata = ({ params: { locale } }) => {
    * ```
    */
   const multilingualUrls = getMultilingualUrls("/");
+  const localizedUrl = multilingualUrls[locale];
 
   return {
     ...metadata,
     alternates: {
-      canonical: multilingualUrls[locale],
+      canonical: localizedUrl,
       languages: { ...multilingualUrls, "x-default": "/" },
     },
     openGraph: {
-      url: multilingualUrls[locale],
+      url: localizedUrl,
     },
   };
 };