nuxtseo-shared 5.1.3 → 5.1.4

package/dist/i18n.d.mts

@@ -23,6 +23,29 @@ interface StrategyProps {
 }
 declare function generatePathForI18nPages(ctx: StrategyProps): string;
 declare function splitPathForI18nLocales(path: string, autoI18n: AutoI18nConfig): string | string[];
+interface ExpandedLocaleRoute {
+    locale: string;
+    path: string;
+}
+/**
+ * Detect a compacted i18n route such as `/:locale(en|fr)/about`.
+ *
+ * Both `nuxt-i18n-micro` and `@nuxtjs/i18n` (experimental `compactRoutes`) collapse
+ * per-locale routes into a single regex route using this syntax, so route-table
+ * consumers (sitemap, link-checker) see one `:locale(...)` route instead of one per
+ * locale.
+ */
+declare function isCompactLocaleRoute(path: string): boolean;
+/**
+ * Expand a compacted i18n route into one entry per locale.
+ *
+ * `/:locale(en|fr)/about` -> `[{ locale: 'en', path: '/en/about' }, { locale: 'fr', path: '/fr/about' }]`
+ *
+ * Pass `knownLocales` to guard against a genuine `:locale` route param: when provided,
+ * expansion only runs if at least one captured token is a real locale code. Returns
+ * `null` when the path is not a compacted locale route.
+ */
+declare function expandCompactLocaleRoute(path: string, knownLocales?: string[]): ExpandedLocaleRoute[] | null;
 declare function normalizeLocales(nuxtI18nConfig: NuxtI18nOptions): AutoI18nConfig['locales'];
 declare function mapPathForI18nPages(path: string, autoI18n: AutoI18nConfig): string[] | false;
 interface I18nModuleResolution {
@@ -40,5 +63,5 @@ declare function resolveI18nConfig(logger?: {
 }): Promise<false | AutoI18nConfig>;
 declare function mergeOnKey<T extends Record<string, any>>(arr: T[], key: keyof T): T[];
 
-export { generatePathForI18nPages, mapPathForI18nPages, mergeOnKey, normalizeLocales, resolveI18nConfig, resolveI18nModule, splitPathForI18nLocales };
-export type { AutoI18nConfig, I18nModuleResolution, NormalisedLocale, Strategies, StrategyProps };
+export { expandCompactLocaleRoute, generatePathForI18nPages, isCompactLocaleRoute, mapPathForI18nPages, mergeOnKey, normalizeLocales, resolveI18nConfig, resolveI18nModule, splitPathForI18nLocales };
+export type { AutoI18nConfig, ExpandedLocaleRoute, I18nModuleResolution, NormalisedLocale, Strategies, StrategyProps };

package/dist/i18n.d.ts

@@ -23,6 +23,29 @@ interface StrategyProps {
 }
 declare function generatePathForI18nPages(ctx: StrategyProps): string;
 declare function splitPathForI18nLocales(path: string, autoI18n: AutoI18nConfig): string | string[];
+interface ExpandedLocaleRoute {
+    locale: string;
+    path: string;
+}
+/**
+ * Detect a compacted i18n route such as `/:locale(en|fr)/about`.
+ *
+ * Both `nuxt-i18n-micro` and `@nuxtjs/i18n` (experimental `compactRoutes`) collapse
+ * per-locale routes into a single regex route using this syntax, so route-table
+ * consumers (sitemap, link-checker) see one `:locale(...)` route instead of one per
+ * locale.
+ */
+declare function isCompactLocaleRoute(path: string): boolean;
+/**
+ * Expand a compacted i18n route into one entry per locale.
+ *
+ * `/:locale(en|fr)/about` -> `[{ locale: 'en', path: '/en/about' }, { locale: 'fr', path: '/fr/about' }]`
+ *
+ * Pass `knownLocales` to guard against a genuine `:locale` route param: when provided,
+ * expansion only runs if at least one captured token is a real locale code. Returns
+ * `null` when the path is not a compacted locale route.
+ */
+declare function expandCompactLocaleRoute(path: string, knownLocales?: string[]): ExpandedLocaleRoute[] | null;
 declare function normalizeLocales(nuxtI18nConfig: NuxtI18nOptions): AutoI18nConfig['locales'];
 declare function mapPathForI18nPages(path: string, autoI18n: AutoI18nConfig): string[] | false;
 interface I18nModuleResolution {
@@ -40,5 +63,5 @@ declare function resolveI18nConfig(logger?: {
 }): Promise<false | AutoI18nConfig>;
 declare function mergeOnKey<T extends Record<string, any>>(arr: T[], key: keyof T): T[];
 
-export { generatePathForI18nPages, mapPathForI18nPages, mergeOnKey, normalizeLocales, resolveI18nConfig, resolveI18nModule, splitPathForI18nLocales };
-export type { AutoI18nConfig, I18nModuleResolution, NormalisedLocale, Strategies, StrategyProps };
+export { expandCompactLocaleRoute, generatePathForI18nPages, isCompactLocaleRoute, mapPathForI18nPages, mergeOnKey, normalizeLocales, resolveI18nConfig, resolveI18nModule, splitPathForI18nLocales };
+export type { AutoI18nConfig, ExpandedLocaleRoute, I18nModuleResolution, NormalisedLocale, Strategies, StrategyProps };

package/dist/i18n.mjs

@@ -1,7 +1,9 @@
 import { getNuxtModuleVersion, hasNuxtModuleCompatibility, hasNuxtModule } from '@nuxt/kit';
 import { joinURL, withHttps, withBase, withLeadingSlash } from 'ufo';
 import { getNuxtModuleOptions } from './kit.mjs';
+import 'node:url';
 import 'pathe';
+import 'pkg-types';
 import 'std-env';
 
 const I18N_MODULES = ["@nuxtjs/i18n", "nuxt-i18n-micro"];
@@ -33,6 +35,22 @@ function splitPathForI18nLocales(path, autoI18n) {
     ...locales.map((l) => `/${l.code}${path}`)
   ];
 }
+const COMPACT_LOCALE_PATTERN = /^\/:locale\(([^)]+)\)/;
+function isCompactLocaleRoute(path) {
+  return COMPACT_LOCALE_PATTERN.test(path);
+}
+function expandCompactLocaleRoute(path, knownLocales) {
+  const match = COMPACT_LOCALE_PATTERN.exec(path);
+  if (!match?.[1])
+    return null;
+  const locales = match[1].split("|");
+  if (knownLocales?.length && !locales.some((l) => knownLocales.includes(l)))
+    return null;
+  return locales.map((locale) => ({
+    locale,
+    path: path.replace(COMPACT_LOCALE_PATTERN, `/${locale}`)
+  }));
+}
 function normalizeLocales(nuxtI18nConfig) {
   const rawLocales = nuxtI18nConfig.locales || [];
   let onlyLocales = nuxtI18nConfig?.bundle?.onlyLocales || [];
@@ -131,4 +149,4 @@ function mergeOnKey(arr, key) {
   return [...map.values()];
 }
 
-export { generatePathForI18nPages, mapPathForI18nPages, mergeOnKey, normalizeLocales, resolveI18nConfig, resolveI18nModule, splitPathForI18nLocales };
+export { expandCompactLocaleRoute, generatePathForI18nPages, isCompactLocaleRoute, mapPathForI18nPages, mergeOnKey, normalizeLocales, resolveI18nConfig, resolveI18nModule, splitPathForI18nLocales };

package/dist/kit.d.mts

@@ -48,6 +48,28 @@ interface NuxtContentVersion {
  * Returns `false` when @nuxt/content is not installed or the version is unrecognised.
  */
 declare function resolveNuxtContentVersion(): Promise<false | NuxtContentVersion>;
+/**
+ * Read the major version of a non-module package as resolved from `rootDir`.
+ *
+ * Unlike `hasNuxtModuleCompatibility`, this works for plain libraries (e.g.
+ * `unhead`, `@unhead/vue`) that aren't registered as Nuxt modules. Returns
+ * `undefined` when the package can't be resolved or has no parseable version.
+ */
+declare function resolvePackageMajor(id: string, rootDir: string): Promise<number | undefined>;
+type UnheadMajor = 2 | 3;
+/**
+ * Resolve the major of the unhead the host app renders with.
+ *
+ * `@unhead/vue` is what the head-stack packages peer-depend on, so it's the
+ * primary signal; falls back to the core `unhead` package, then to `3` (the
+ * current default major) when neither resolves.
+ *
+ * Used to keep head-stack dependencies on a compatible major. For example,
+ * `@unhead/schema-org` v3 attaches an object `_resolver` to every graph node
+ * that unhead v2's `walkResolver` invokes as a thunk, crashing render; a module
+ * that ships both majors can use this to alias to the matching one.
+ */
+declare function resolveHostUnheadMajor(rootDir: string): Promise<UnheadMajor>;
 
-export { createNitroPromise, createPagesPromise, detectNuxtSeoModules, detectTarget, extendTypes, getNuxtModuleOptions, isNuxtGenerate, resolveNitroPreset, resolveNuxtContentVersion };
-export type { NuxtContentVersion, NuxtSeoModuleDetection };
+export { createNitroPromise, createPagesPromise, detectNuxtSeoModules, detectTarget, extendTypes, getNuxtModuleOptions, isNuxtGenerate, resolveHostUnheadMajor, resolveNitroPreset, resolveNuxtContentVersion, resolvePackageMajor };
+export type { NuxtContentVersion, NuxtSeoModuleDetection, UnheadMajor };

package/dist/kit.d.ts

@@ -48,6 +48,28 @@ interface NuxtContentVersion {
  * Returns `false` when @nuxt/content is not installed or the version is unrecognised.
  */
 declare function resolveNuxtContentVersion(): Promise<false | NuxtContentVersion>;
+/**
+ * Read the major version of a non-module package as resolved from `rootDir`.
+ *
+ * Unlike `hasNuxtModuleCompatibility`, this works for plain libraries (e.g.
+ * `unhead`, `@unhead/vue`) that aren't registered as Nuxt modules. Returns
+ * `undefined` when the package can't be resolved or has no parseable version.
+ */
+declare function resolvePackageMajor(id: string, rootDir: string): Promise<number | undefined>;
+type UnheadMajor = 2 | 3;
+/**
+ * Resolve the major of the unhead the host app renders with.
+ *
+ * `@unhead/vue` is what the head-stack packages peer-depend on, so it's the
+ * primary signal; falls back to the core `unhead` package, then to `3` (the
+ * current default major) when neither resolves.
+ *
+ * Used to keep head-stack dependencies on a compatible major. For example,
+ * `@unhead/schema-org` v3 attaches an object `_resolver` to every graph node
+ * that unhead v2's `walkResolver` invokes as a thunk, crashing render; a module
+ * that ships both majors can use this to alias to the matching one.
+ */
+declare function resolveHostUnheadMajor(rootDir: string): Promise<UnheadMajor>;
 
-export { createNitroPromise, createPagesPromise, detectNuxtSeoModules, detectTarget, extendTypes, getNuxtModuleOptions, isNuxtGenerate, resolveNitroPreset, resolveNuxtContentVersion };
-export type { NuxtContentVersion, NuxtSeoModuleDetection };
+export { createNitroPromise, createPagesPromise, detectNuxtSeoModules, detectTarget, extendTypes, getNuxtModuleOptions, isNuxtGenerate, resolveHostUnheadMajor, resolveNitroPreset, resolveNuxtContentVersion, resolvePackageMajor };
+export type { NuxtContentVersion, NuxtSeoModuleDetection, UnheadMajor };

package/dist/kit.mjs

@@ -1,7 +1,13 @@
+import { pathToFileURL } from 'node:url';
 import { useNuxt, createResolver, addTemplate, loadNuxtModuleInstance, tryUseNuxt, hasNuxtModule, hasNuxtModuleCompatibility } from '@nuxt/kit';
-import { relative } from 'pathe';
+import { relative, dirname } from 'pathe';
+import { resolvePackageJSON, readPackageJSON } from 'pkg-types';
 import { provider, env } from 'std-env';
 
+function normalizePackageUrl(rootDir) {
+  const url = rootDir.startsWith("file:") ? rootDir : pathToFileURL(rootDir.endsWith("/") ? rootDir : `${rootDir}/`).href;
+  return url.endsWith("/") ? url : `${url}/`;
+}
 const NUXT_SEO_MODULES = /* @__PURE__ */ new Set([
   "@nuxtjs/robots",
   "@nuxtjs/sitemap",
@@ -115,5 +121,35 @@ async function resolveNuxtContentVersion() {
     return { version: 2 };
   return false;
 }
+async function resolvePackageMajor(id, rootDir) {
+  const url = normalizePackageUrl(rootDir);
+  const version = await readPackageJSON(id, { url }).then((pkg) => pkg.version).catch(() => {
+    return void 0;
+  });
+  const major = version ? Number.parseInt(version, 10) : Number.NaN;
+  return Number.isFinite(major) ? major : void 0;
+}
+async function resolveHostUnheadMajor(rootDir) {
+  const rootUrl = normalizePackageUrl(rootDir);
+  const searchUrls = [];
+  for (const id of ["@nuxt/nitro-server", "nuxt"]) {
+    const pkgJson = await resolvePackageJSON(id, { url: rootUrl }).catch(() => {
+      return void 0;
+    });
+    if (pkgJson)
+      searchUrls.push(`${dirname(pkgJson)}/`);
+  }
+  searchUrls.push(rootUrl);
+  for (const id of ["@unhead/vue", "unhead"]) {
+    for (const url of searchUrls) {
+      const major = await resolvePackageMajor(id, url);
+      if (major === 2)
+        return 2;
+      if (major !== void 0 && major >= 3)
+        return 3;
+    }
+  }
+  return 3;
+}
 
-export { createNitroPromise, createPagesPromise, detectNuxtSeoModules, detectTarget, extendTypes, getNuxtModuleOptions, isNuxtGenerate, resolveNitroPreset, resolveNuxtContentVersion };
+export { createNitroPromise, createPagesPromise, detectNuxtSeoModules, detectTarget, extendTypes, getNuxtModuleOptions, isNuxtGenerate, resolveHostUnheadMajor, resolveNitroPreset, resolveNuxtContentVersion, resolvePackageMajor };

package/dist/module.json

@@ -4,7 +4,7 @@
   "compatibility": {
     "nuxt": ">=3.16.0"
   },
-  "version": "5.1.3",
+  "version": "5.1.4",
   "builder": {
     "@nuxt/module-builder": "1.0.2",
     "unbuild": "3.6.1"

package/dist/module.mjs

@@ -4,7 +4,9 @@ import 'nuxt-site-config/kit';
 import 'ofetch';
 import 'std-env';
 import './kit.mjs';
+import 'node:url';
 import 'pathe';
+import 'pkg-types';
 
 const module$1 = defineNuxtModule({
   meta: {

package/dist/pro.mjs

@@ -3,7 +3,9 @@ import { useSiteConfig } from 'nuxt-site-config/kit';
 import { $fetch } from 'ofetch';
 import { isTest } from 'std-env';
 import { detectNuxtSeoModules } from './kit.mjs';
+import 'node:url';
 import 'pathe';
+import 'pkg-types';
 
 function hookNuxtSeoProDataUpload() {
   const nuxt = useNuxt();

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "nuxtseo-shared",
   "type": "module",
-  "version": "5.1.3",
+  "version": "5.1.4",
   "description": "Shared utilities for Nuxt SEO modules.",
   "author": {
     "name": "Harlan Wilton",
@@ -75,30 +75,32 @@
     }
   },
   "dependencies": {
-    "@clack/prompts": "^1.2.0",
+    "@clack/prompts": "^1.5.1",
     "@nuxt/devtools-kit": "4.0.0-alpha.3",
-    "@nuxt/kit": "^4.4.2",
+    "@nuxt/kit": "^4.4.7",
     "birpc": "^4.0.0",
     "consola": "^3.4.2",
     "defu": "^6.1.7",
     "ofetch": "^1.5.1",
     "pathe": "^2.0.3",
-    "pkg-types": "^2.3.0",
+    "pkg-types": "^2.3.1",
     "radix3": "^1.1.2",
     "sirv": "^3.0.2",
-    "std-env": "^4.0.0",
-    "ufo": "^1.6.3"
+    "std-env": "^4.1.0",
+    "ufo": "^1.6.4"
   },
   "devDependencies": {
-    "@arethetypeswrong/cli": "^0.18.2",
+    "@arethetypeswrong/cli": "^0.18.3",
     "@nuxt/module-builder": "^1.0.2",
-    "@nuxt/schema": "^4.4.2",
-    "@nuxtjs/i18n": "^10.2.4",
+    "@nuxt/schema": "^4.4.7",
+    "@nuxtjs/i18n": "^10.4.0",
+    "nitropack": "^2.13.4",
+    "nuxt": "^4.4.7",
     "nuxt-site-config": "^4.0.8",
-    "typescript": "^6.0.2",
-    "vitest": "^4.1.4",
-    "vue": "^3.5.32",
-    "vue-tsc": "^3.2.6"
+    "typescript": "^6.0.3",
+    "vitest": "^4.1.8",
+    "vue": "^3.5.35",
+    "vue-tsc": "^3.3.3"
   },
   "scripts": {
     "build": "nuxt-module-build build",
@@ -107,6 +109,6 @@
     "test": "vitest",
     "test:run": "vitest run",
     "test:attw": "attw --pack --profile esm-only",
-    "typecheck": "vue-tsc --noEmit"
+    "typecheck": "nuxt typecheck ."
   }
 }