@i18n-micro/vitepress 1.0.1 → 1.1.0

package/dist/config.d.cts

@@ -1,88 +1,62 @@
-import { I18nRoutingStrategy } from '@i18n-micro/vue';
 import { Locale } from '@i18n-micro/types';
 import { Plugin as Plugin_2 } from 'vite';
 import { PluralFunc } from '@i18n-micro/types';
-import { TranslationFileBuckets } from '@i18n-micro/utils/parse-path';
 import { Translations } from '@i18n-micro/types';
 
 /**
- * Apply page dictionaries onto an i18n instance (merged with root).
- */
-export declare function applyLoadedTranslations(i18n: {
-    addTranslations: (locale: string, translations: Translations, merge?: boolean) => void;
-    addRouteTranslations: (locale: string, routeName: string, translations: Translations, merge?: boolean) => void;
-}, loaded: LoadedTranslations): void;
-
-/**
- * Bridge so VitePress navbar language menu and `<I18nSwitcher>` share path logic.
- * Pass the result to `themeConfig.i18nRouting`.
+ * Build i18n SEO head for VitePress — same tags as Nuxt `useLocaleHead` /
+ * plugin `02.meta` (canonical, hreflang, x-default, og:locale / og:url / alternates).
  *
- * `targetLocale` is a **VitePress locale key** (`root` / `fr`). URL prefixes use that key;
- * `localeKeyToCode` is only for resolving the i18n code when callers need it elsewhere.
- *
- * Returns a **self-contained** function (no closures) so VitePress can serialize it
- * into site data via `Function#toString()` + `new Function`.
+ * Framework-agnostic pure function; wired automatically by `withI18n` when `meta` is on.
  */
-export declare function createI18nRoutingFromAdapter(adapterOrOptions: VitePressRouterAdapter | I18nRoutingFromAdapterOptions): VitePressI18nRoutingFn;
+export declare function buildVitePressLocaleHead(options: BuildVitePressLocaleHeadOptions): VitePressLocaleHeadObject;
 
-export declare interface I18nRoutingFromAdapterOptions {
+export declare interface BuildVitePressLocaleHeadOptions {
+    /**
+     * Current page path (with or without `site.base`). Query/hash optional.
+     * Example: `/docs/fr/guide/` or `/fr/guide`.
+     */
+    path: string;
+    locales: Locale[];
     defaultLocale: string;
-    localeCodes: string[];
     localeKeyToCode?: Record<string, string>;
-}
-
-/**
- * List JSON translation files under `translationDir` (absolute + relative paths).
- */
-export declare function listTranslationFiles(options: LoadMessagesOptions): TranslationFileRef[];
-
-export declare type LoadedTranslations = TranslationFileBuckets<Translations>;
-
-/**
- * Load root-level locale JSON only (`en.json`, `fr.json`, …).
- * Prefer `loadTranslationBuckets` when page locales are needed.
- *
- * Node.js-only (`node:fs`). For bundler-friendly loading prefer
- * `withI18nMicro` virtual modules or `messagesFromGlob` in the theme.
- */
-export declare function loadMessages(options: LoadMessagesOptions): Record<string, Translations>;
-
-export declare interface LoadMessagesOptions {
-    /** Directory with locale JSON (`en.json`, `pages/guide/demo/en.json`, …). */
-    translationDir: string;
-    rootDir?: string;
+    /** VitePress `site.base` (e.g. `/docs/`). */
+    base?: string;
     /**
-     * When true, treat `pages/**` files as root-level dictionaries.
-     * @default false
+     * Public site origin **without** trailing slash (e.g. `https://example.com`).
+     * Required for absolute `canonical` / `hreflang` / `og:url`.
+     * When omitted, only `htmlAttrs` are produced.
      */
-    disablePageLocales?: boolean;
+    metaBaseUrl?: string;
+    /** @default false — same as Nuxt / Vue `useLocaleHead`. */
+    hreflangBaseLanguage?: boolean;
+    /** Query keys kept on canonical / alternate URLs. @default [] */
+    canonicalQueryWhitelist?: string[];
+    /** @default true */
+    addDirAttribute?: boolean;
+    /** @default true */
+    addSeoAttributes?: boolean;
+    /** @default 'id' */
+    identifierAttribute?: string;
+    missingWarn?: boolean;
 }
 
 /**
- * Load root + page-scoped dictionaries (`pages/** /xx.json`).
- * Node.js-only (`node:fs`).
+ * Build VitePress `config.locales` from i18n-micro `Locale[]`.
+ * Default locale becomes `root` (no URL prefix); others get `/{key}/`.
  */
-export declare function loadTranslationBuckets(options: LoadMessagesOptions): LoadedTranslations;
+export declare function buildVitePressLocales(locales: Locale[], defaultLocale: string, options?: BuildVitePressLocalesOptions): Record<string, VitePressLocaleEntry>;
 
-export declare interface TranslationFileRef {
-    /** Path relative to `translationDir` using `/` separators. */
-    relativePath: string;
-    absolutePath: string;
-}
-
-export declare interface VirtualI18nConfig {
-    defaultLocale: string;
-    fallbackLocale: string;
-    locales: Locale[];
-    localeCodes: string[];
-    missingWarn: boolean;
-    syncWithVitePress: boolean;
-    translationDir: string;
-    disablePageLocales: boolean;
-    localeKeyToCode: Record<string, string>;
+export declare interface BuildVitePressLocalesOptions {
+    /**
+     * Map VitePress locale keys → i18n codes (`root` → default).
+     * When a non-default code maps to a short VP key (`fr` → `fr-FR`), the URL
+     * prefix / config key uses the VP key.
+     */
+    localeKeyToCode?: Record<string, string>;
 }
 
-declare interface VitePressI18nOptions {
+declare interface CreateI18nOptions {
     locale: string;
     fallbackLocale?: string;
     locales?: Locale[];
@@ -90,7 +64,7 @@ declare interface VitePressI18nOptions {
     messages?: Record<string, Translations>;
     /**
      * Page-scoped dictionaries keyed by route name (`guide-demo`), then locale.
-     * Loaded from `locales/pages/**` when using `withI18nMicro`.
+     * Loaded from `locales/pages/**` when using `withI18n`.
      */
     routeMessages?: Record<string, Record<string, Translations>>;
     plural?: PluralFunc;
@@ -105,52 +79,51 @@ declare interface VitePressI18nOptions {
      * Map VitePress locale keys to i18n codes (`root` → default locale code).
      */
     localeKeyToCode?: Record<string, string>;
+    /**
+     * VitePress `site.base`. Needed so SSG paths (`withBase`) and lang switcher
+     * do not treat the base segment as content / double-prefix links.
+     */
+    base?: string;
 }
 
 /**
- * Minimal shapes used by VitePress `themeConfig.i18nRouting`.
- * Kept loose so we do not hard-depend on VitePress internal DefaultTheme types at compile time.
+ * Convert VitePress `pageData.relativePath` to a route path (cleanUrls-style).
  */
-export declare interface VitePressI18nRoutingData {
-    site?: {
-        value?: {
-            locales?: Record<string, {
-                link?: string;
-                lang?: string;
-            }>;
-        };
-    };
-    localeIndex?: {
-        value?: string;
-    };
+export declare function relativePathToRoutePath(relativePath: string): string;
+
+export declare interface VirtualI18nConfig {
+    defaultLocale: string;
+    fallbackLocale: string;
+    locales: Locale[];
+    localeCodes: string[];
+    missingWarn: boolean;
+    syncWithVitePress: boolean;
+    translationDir: string;
+    disablePageLocales: boolean;
+    localeKeyToCode: Record<string, string>;
+    /** VitePress `site.base` (normalized, trailing slash preserved from config). */
+    base?: string;
 }
 
-export declare type VitePressI18nRoutingFn = (data: VitePressI18nRoutingData, route: VitePressI18nRoutingRoute, targetLocale: string) => string;
+/** VitePress `HeadConfig` tuple (tag + attrs). */
+export declare type VitePressHeadTuple = [string, Record<string, string>];
 
-export declare interface VitePressI18nRoutingRoute {
-    path: string;
-    hash?: string;
-    query?: string;
-    data?: {
-        relativePath?: string;
-    };
+/**
+ * Minimal VitePress `locales` entry used by the default theme language menu.
+ */
+export declare interface VitePressLocaleEntry {
+    label: string;
+    lang: string;
+    link?: string;
 }
 
-declare interface VitePressRouterAdapter extends I18nRoutingStrategy {
-    getLocaleFromPath: (path: string) => string;
-    switchLocalePath: (path: string, newLocale: string) => string;
-    localizePath: (path: string, locale: string) => string;
-    removeLocaleFromPath: (path: string) => string;
-    /** Resolve VitePress locale key (`root` / `fr`) to i18n code. */
-    codeFromLocaleKey: (localeKey: string) => string;
-    /** Resolve i18n code to VitePress locale key. */
-    localeKeyFromCode: (code: string) => string;
-    localeCodes: string[];
-    defaultLocale: string;
-    /** Snapshot of mapping used when building the adapter (for `i18nRouting` serialization). */
-    localeKeyToCode: Record<string, string>;
-    /** URL path prefixes (VitePress locale keys except `root`). */
-    urlPrefixes: string[];
+export declare interface VitePressLocaleHeadObject {
+    htmlAttrs: {
+        lang?: string;
+        dir?: 'ltr' | 'rtl' | 'auto';
+    };
+    /** Ready for `transformHead` / `frontmatter.head`. */
+    head: VitePressHeadTuple[];
 }
 
 /**
@@ -158,31 +131,38 @@ declare interface VitePressRouterAdapter extends I18nRoutingStrategy {
  * Avoid importing `vitepress` types so the package stays usable as a pure library dep.
  */
 export declare interface VitePressUserConfigLike {
+    base?: string;
     locales?: Record<string, unknown>;
+    themeConfig?: Record<string, unknown> | null;
+    transformHead?: (...args: any[]) => any;
+    transformPageData?: (...args: any[]) => any;
     vite?: {
         plugins?: Plugin_2[] | Plugin_2[][];
+        ssr?: {
+            noExternal?: string | true | Array<string | RegExp>;
+            [key: string]: unknown;
+        };
         [key: string]: unknown;
     };
     [key: string]: unknown;
 }
 
-export declare function warnLocaleMismatch(config: VitePressUserConfigLike, options: WithI18nMicroOptions): void;
+export declare function warnLocaleMismatch(config: VitePressUserConfigLike, options: WithI18nOptions): void;
 
 /**
- * Config helper (like `withMermaid`). Name is `withI18nMicro` on purpose —
- * `withI18n` is already used by the unrelated `vitepress-i18n` package.
+ * VitePress config helper: virtual modules + optional `i18nRouting` / SEO head.
  *
- * Registers virtual modules:
+ * Registers:
  * - `virtual:i18n-micro/config`
  * - `virtual:i18n-micro/messages` (from `translationDir`, default `locales/`)
  *
- * Pair with `defineI18nTheme(DefaultTheme)` — no manual `import.meta.glob` in the theme.
- *
+ * By default also sets `themeConfig.i18nRouting` (pass `i18nRouting: false` to skip).
+ * Pair with `defineI18nTheme(DefaultTheme)` from `@i18n-micro/vitepress/theme`.
  * Import from `@i18n-micro/vitepress/config` (Node / config files only).
  */
-export declare function withI18nMicro<T extends VitePressUserConfigLike>(config: T, options: WithI18nMicroOptions): T;
+export declare function withI18n<T extends VitePressUserConfigLike>(config: T, options: WithI18nOptions): T;
 
-export declare interface WithI18nMicroOptions extends VitePressI18nOptions {
+export declare interface WithI18nOptions extends CreateI18nOptions {
     /**
      * Directory with locale JSON (`en.json`, `pages/guide/demo/en.json`, …), relative to Vite root
      * (VitePress content / docs root). Used by `virtual:i18n-micro/messages`.
@@ -200,6 +180,28 @@ export declare interface WithI18nMicroOptions extends VitePressI18nOptions {
      * @default true
      */
     warnOnLocaleMismatch?: boolean;
+    /**
+     * Inject `themeConfig.i18nRouting` from adapter options + `config.base`.
+     * Set `false` to skip. Skipped automatically when `themeConfig.i18nRouting` is already set.
+     * @default true
+     */
+    i18nRouting?: boolean;
+    /**
+     * Emit i18n SEO tags via `transformHead` (canonical, hreflang, og:locale…) —
+     * Nuxt `meta` / plugin `02.meta` analogue.
+     * Absolute link tags require `metaBaseUrl`.
+     * @default true when `metaBaseUrl` is set, otherwise false
+     */
+    meta?: boolean;
+    /**
+     * Public origin without trailing slash (`https://example.com`).
+     * Same role as Nuxt `metaBaseUrl`.
+     */
+    metaBaseUrl?: string;
+    /** Also emit bare-language hreflang from `iso` (Nuxt `hreflangBaseLanguage`). @default false */
+    hreflangBaseLanguage?: boolean;
+    /** Query keys kept on canonical / alternate URLs. @default [] */
+    canonicalQueryWhitelist?: string[];
 }
 
 export { }

package/dist/config.d.ts

@@ -1,88 +1,62 @@
-import { I18nRoutingStrategy } from '@i18n-micro/vue';
 import { Locale } from '@i18n-micro/types';
 import { Plugin as Plugin_2 } from 'vite';
 import { PluralFunc } from '@i18n-micro/types';
-import { TranslationFileBuckets } from '@i18n-micro/utils/parse-path';
 import { Translations } from '@i18n-micro/types';
 
 /**
- * Apply page dictionaries onto an i18n instance (merged with root).
- */
-export declare function applyLoadedTranslations(i18n: {
-    addTranslations: (locale: string, translations: Translations, merge?: boolean) => void;
-    addRouteTranslations: (locale: string, routeName: string, translations: Translations, merge?: boolean) => void;
-}, loaded: LoadedTranslations): void;
-
-/**
- * Bridge so VitePress navbar language menu and `<I18nSwitcher>` share path logic.
- * Pass the result to `themeConfig.i18nRouting`.
+ * Build i18n SEO head for VitePress — same tags as Nuxt `useLocaleHead` /
+ * plugin `02.meta` (canonical, hreflang, x-default, og:locale / og:url / alternates).
  *
- * `targetLocale` is a **VitePress locale key** (`root` / `fr`). URL prefixes use that key;
- * `localeKeyToCode` is only for resolving the i18n code when callers need it elsewhere.
- *
- * Returns a **self-contained** function (no closures) so VitePress can serialize it
- * into site data via `Function#toString()` + `new Function`.
+ * Framework-agnostic pure function; wired automatically by `withI18n` when `meta` is on.
  */
-export declare function createI18nRoutingFromAdapter(adapterOrOptions: VitePressRouterAdapter | I18nRoutingFromAdapterOptions): VitePressI18nRoutingFn;
+export declare function buildVitePressLocaleHead(options: BuildVitePressLocaleHeadOptions): VitePressLocaleHeadObject;
 
-export declare interface I18nRoutingFromAdapterOptions {
+export declare interface BuildVitePressLocaleHeadOptions {
+    /**
+     * Current page path (with or without `site.base`). Query/hash optional.
+     * Example: `/docs/fr/guide/` or `/fr/guide`.
+     */
+    path: string;
+    locales: Locale[];
     defaultLocale: string;
-    localeCodes: string[];
     localeKeyToCode?: Record<string, string>;
-}
-
-/**
- * List JSON translation files under `translationDir` (absolute + relative paths).
- */
-export declare function listTranslationFiles(options: LoadMessagesOptions): TranslationFileRef[];
-
-export declare type LoadedTranslations = TranslationFileBuckets<Translations>;
-
-/**
- * Load root-level locale JSON only (`en.json`, `fr.json`, …).
- * Prefer `loadTranslationBuckets` when page locales are needed.
- *
- * Node.js-only (`node:fs`). For bundler-friendly loading prefer
- * `withI18nMicro` virtual modules or `messagesFromGlob` in the theme.
- */
-export declare function loadMessages(options: LoadMessagesOptions): Record<string, Translations>;
-
-export declare interface LoadMessagesOptions {
-    /** Directory with locale JSON (`en.json`, `pages/guide/demo/en.json`, …). */
-    translationDir: string;
-    rootDir?: string;
+    /** VitePress `site.base` (e.g. `/docs/`). */
+    base?: string;
     /**
-     * When true, treat `pages/**` files as root-level dictionaries.
-     * @default false
+     * Public site origin **without** trailing slash (e.g. `https://example.com`).
+     * Required for absolute `canonical` / `hreflang` / `og:url`.
+     * When omitted, only `htmlAttrs` are produced.
      */
-    disablePageLocales?: boolean;
+    metaBaseUrl?: string;
+    /** @default false — same as Nuxt / Vue `useLocaleHead`. */
+    hreflangBaseLanguage?: boolean;
+    /** Query keys kept on canonical / alternate URLs. @default [] */
+    canonicalQueryWhitelist?: string[];
+    /** @default true */
+    addDirAttribute?: boolean;
+    /** @default true */
+    addSeoAttributes?: boolean;
+    /** @default 'id' */
+    identifierAttribute?: string;
+    missingWarn?: boolean;
 }
 
 /**
- * Load root + page-scoped dictionaries (`pages/** /xx.json`).
- * Node.js-only (`node:fs`).
+ * Build VitePress `config.locales` from i18n-micro `Locale[]`.
+ * Default locale becomes `root` (no URL prefix); others get `/{key}/`.
  */
-export declare function loadTranslationBuckets(options: LoadMessagesOptions): LoadedTranslations;
+export declare function buildVitePressLocales(locales: Locale[], defaultLocale: string, options?: BuildVitePressLocalesOptions): Record<string, VitePressLocaleEntry>;
 
-export declare interface TranslationFileRef {
-    /** Path relative to `translationDir` using `/` separators. */
-    relativePath: string;
-    absolutePath: string;
-}
-
-export declare interface VirtualI18nConfig {
-    defaultLocale: string;
-    fallbackLocale: string;
-    locales: Locale[];
-    localeCodes: string[];
-    missingWarn: boolean;
-    syncWithVitePress: boolean;
-    translationDir: string;
-    disablePageLocales: boolean;
-    localeKeyToCode: Record<string, string>;
+export declare interface BuildVitePressLocalesOptions {
+    /**
+     * Map VitePress locale keys → i18n codes (`root` → default).
+     * When a non-default code maps to a short VP key (`fr` → `fr-FR`), the URL
+     * prefix / config key uses the VP key.
+     */
+    localeKeyToCode?: Record<string, string>;
 }
 
-declare interface VitePressI18nOptions {
+declare interface CreateI18nOptions {
     locale: string;
     fallbackLocale?: string;
     locales?: Locale[];
@@ -90,7 +64,7 @@ declare interface VitePressI18nOptions {
     messages?: Record<string, Translations>;
     /**
      * Page-scoped dictionaries keyed by route name (`guide-demo`), then locale.
-     * Loaded from `locales/pages/**` when using `withI18nMicro`.
+     * Loaded from `locales/pages/**` when using `withI18n`.
      */
     routeMessages?: Record<string, Record<string, Translations>>;
     plural?: PluralFunc;
@@ -105,52 +79,51 @@ declare interface VitePressI18nOptions {
      * Map VitePress locale keys to i18n codes (`root` → default locale code).
      */
     localeKeyToCode?: Record<string, string>;
+    /**
+     * VitePress `site.base`. Needed so SSG paths (`withBase`) and lang switcher
+     * do not treat the base segment as content / double-prefix links.
+     */
+    base?: string;
 }
 
 /**
- * Minimal shapes used by VitePress `themeConfig.i18nRouting`.
- * Kept loose so we do not hard-depend on VitePress internal DefaultTheme types at compile time.
+ * Convert VitePress `pageData.relativePath` to a route path (cleanUrls-style).
  */
-export declare interface VitePressI18nRoutingData {
-    site?: {
-        value?: {
-            locales?: Record<string, {
-                link?: string;
-                lang?: string;
-            }>;
-        };
-    };
-    localeIndex?: {
-        value?: string;
-    };
+export declare function relativePathToRoutePath(relativePath: string): string;
+
+export declare interface VirtualI18nConfig {
+    defaultLocale: string;
+    fallbackLocale: string;
+    locales: Locale[];
+    localeCodes: string[];
+    missingWarn: boolean;
+    syncWithVitePress: boolean;
+    translationDir: string;
+    disablePageLocales: boolean;
+    localeKeyToCode: Record<string, string>;
+    /** VitePress `site.base` (normalized, trailing slash preserved from config). */
+    base?: string;
 }
 
-export declare type VitePressI18nRoutingFn = (data: VitePressI18nRoutingData, route: VitePressI18nRoutingRoute, targetLocale: string) => string;
+/** VitePress `HeadConfig` tuple (tag + attrs). */
+export declare type VitePressHeadTuple = [string, Record<string, string>];
 
-export declare interface VitePressI18nRoutingRoute {
-    path: string;
-    hash?: string;
-    query?: string;
-    data?: {
-        relativePath?: string;
-    };
+/**
+ * Minimal VitePress `locales` entry used by the default theme language menu.
+ */
+export declare interface VitePressLocaleEntry {
+    label: string;
+    lang: string;
+    link?: string;
 }
 
-declare interface VitePressRouterAdapter extends I18nRoutingStrategy {
-    getLocaleFromPath: (path: string) => string;
-    switchLocalePath: (path: string, newLocale: string) => string;
-    localizePath: (path: string, locale: string) => string;
-    removeLocaleFromPath: (path: string) => string;
-    /** Resolve VitePress locale key (`root` / `fr`) to i18n code. */
-    codeFromLocaleKey: (localeKey: string) => string;
-    /** Resolve i18n code to VitePress locale key. */
-    localeKeyFromCode: (code: string) => string;
-    localeCodes: string[];
-    defaultLocale: string;
-    /** Snapshot of mapping used when building the adapter (for `i18nRouting` serialization). */
-    localeKeyToCode: Record<string, string>;
-    /** URL path prefixes (VitePress locale keys except `root`). */
-    urlPrefixes: string[];
+export declare interface VitePressLocaleHeadObject {
+    htmlAttrs: {
+        lang?: string;
+        dir?: 'ltr' | 'rtl' | 'auto';
+    };
+    /** Ready for `transformHead` / `frontmatter.head`. */
+    head: VitePressHeadTuple[];
 }
 
 /**
@@ -158,31 +131,38 @@ declare interface VitePressRouterAdapter extends I18nRoutingStrategy {
  * Avoid importing `vitepress` types so the package stays usable as a pure library dep.
  */
 export declare interface VitePressUserConfigLike {
+    base?: string;
     locales?: Record<string, unknown>;
+    themeConfig?: Record<string, unknown> | null;
+    transformHead?: (...args: any[]) => any;
+    transformPageData?: (...args: any[]) => any;
     vite?: {
         plugins?: Plugin_2[] | Plugin_2[][];
+        ssr?: {
+            noExternal?: string | true | Array<string | RegExp>;
+            [key: string]: unknown;
+        };
         [key: string]: unknown;
     };
     [key: string]: unknown;
 }
 
-export declare function warnLocaleMismatch(config: VitePressUserConfigLike, options: WithI18nMicroOptions): void;
+export declare function warnLocaleMismatch(config: VitePressUserConfigLike, options: WithI18nOptions): void;
 
 /**
- * Config helper (like `withMermaid`). Name is `withI18nMicro` on purpose —
- * `withI18n` is already used by the unrelated `vitepress-i18n` package.
+ * VitePress config helper: virtual modules + optional `i18nRouting` / SEO head.
  *
- * Registers virtual modules:
+ * Registers:
  * - `virtual:i18n-micro/config`
  * - `virtual:i18n-micro/messages` (from `translationDir`, default `locales/`)
  *
- * Pair with `defineI18nTheme(DefaultTheme)` — no manual `import.meta.glob` in the theme.
- *
+ * By default also sets `themeConfig.i18nRouting` (pass `i18nRouting: false` to skip).
+ * Pair with `defineI18nTheme(DefaultTheme)` from `@i18n-micro/vitepress/theme`.
  * Import from `@i18n-micro/vitepress/config` (Node / config files only).
  */
-export declare function withI18nMicro<T extends VitePressUserConfigLike>(config: T, options: WithI18nMicroOptions): T;
+export declare function withI18n<T extends VitePressUserConfigLike>(config: T, options: WithI18nOptions): T;
 
-export declare interface WithI18nMicroOptions extends VitePressI18nOptions {
+export declare interface WithI18nOptions extends CreateI18nOptions {
     /**
      * Directory with locale JSON (`en.json`, `pages/guide/demo/en.json`, …), relative to Vite root
      * (VitePress content / docs root). Used by `virtual:i18n-micro/messages`.
@@ -200,6 +180,28 @@ export declare interface WithI18nMicroOptions extends VitePressI18nOptions {
      * @default true
      */
     warnOnLocaleMismatch?: boolean;
+    /**
+     * Inject `themeConfig.i18nRouting` from adapter options + `config.base`.
+     * Set `false` to skip. Skipped automatically when `themeConfig.i18nRouting` is already set.
+     * @default true
+     */
+    i18nRouting?: boolean;
+    /**
+     * Emit i18n SEO tags via `transformHead` (canonical, hreflang, og:locale…) —
+     * Nuxt `meta` / plugin `02.meta` analogue.
+     * Absolute link tags require `metaBaseUrl`.
+     * @default true when `metaBaseUrl` is set, otherwise false
+     */
+    meta?: boolean;
+    /**
+     * Public origin without trailing slash (`https://example.com`).
+     * Same role as Nuxt `metaBaseUrl`.
+     */
+    metaBaseUrl?: string;
+    /** Also emit bare-language hreflang from `iso` (Nuxt `hreflangBaseLanguage`). @default false */
+    hreflangBaseLanguage?: boolean;
+    /** Query keys kept on canonical / alternate URLs. @default [] */
+    canonicalQueryWhitelist?: string[];
 }
 
 export { }