@i18n-micro/utils 1.0.11 → 1.0.13

package/dist/auto-detect-path.cjs

@@ -0,0 +1 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});function i(e,o={}){const t=o.autoDetectPath??"/",r=!e||e===""?"/":e;if(t==="*")return!0;if(t==="no_prefix")return!o.hasLocalePrefix;if(t==="/"||t==="")return r==="/";const c=t.startsWith("/")?t:`/${t}`;return r===c||r===`${c}/`}exports.shouldAttemptLocaleRedirect=i;

package/dist/auto-detect-path.d.cts

@@ -0,0 +1,16 @@
+/**
+ * Whether cookie / Accept-Language preference may steer locale redirects (#242).
+ *
+ * Modes (`ModuleOptions.autoDetectPath`):
+ * - `'/'` (default) — only `/`
+ * - `'no_prefix'` — any path without a locale prefix
+ * - `'*'` — every path (also enables aggressive prefixed-URL rewrites in the plugin)
+ * - any other string — exact path match
+ *
+ * Does not gate strategy / `localeRoutes` canonicalization: when preference is denied on an
+ * unprefixed path, the plugin still runs `getClientRedirect` with the default locale.
+ */
+export declare function shouldAttemptLocaleRedirect(path: string, options?: {
+    autoDetectPath?: string;
+    hasLocalePrefix?: boolean;
+}): boolean;

package/dist/auto-detect-path.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Whether cookie / Accept-Language preference may steer locale redirects (#242).
+ *
+ * Modes (`ModuleOptions.autoDetectPath`):
+ * - `'/'` (default) — only `/`
+ * - `'no_prefix'` — any path without a locale prefix
+ * - `'*'` — every path (also enables aggressive prefixed-URL rewrites in the plugin)
+ * - any other string — exact path match
+ *
+ * Does not gate strategy / `localeRoutes` canonicalization: when preference is denied on an
+ * unprefixed path, the plugin still runs `getClientRedirect` with the default locale.
+ */
+export declare function shouldAttemptLocaleRedirect(path: string, options?: {
+    autoDetectPath?: string;
+    hasLocalePrefix?: boolean;
+}): boolean;

package/dist/auto-detect-path.mjs

@@ -0,0 +1,13 @@
+function c(e, n = {}) {
+  const t = n.autoDetectPath ?? "/", r = !e || e === "" ? "/" : e;
+  if (t === "*") return !0;
+  if (t === "no_prefix")
+    return !n.hasLocalePrefix;
+  if (t === "/" || t === "")
+    return r === "/";
+  const o = t.startsWith("/") ? t : `/${t}`;
+  return r === o || r === `${o}/`;
+}
+export {
+  c as shouldAttemptLocaleRedirect
+};

package/dist/resolve-hreflang.cjs

@@ -0,0 +1 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});function l(e){return e.iso?.trim()||String(e.code)}function u(e){const r=e.match(/^([A-Za-z]{2,3})(?:[-_](.+))?$/);return r?{language:r[1],region:r[2]}:{language:e}}function d(e,r={}){const{hreflangBaseLanguage:f=!1}=r;if(!f)return e.map(t=>{const o=String(t.code);return{hreflang:l(t),localeCode:o}});const s=new Map;for(const t of e){const o=String(t.code),a=l(t),{language:n,region:i}=u(a);n&&i&&!s.has(n)&&s.set(n,o),s.set(a,o)}const g=new Set,c=[];for(const t of e){const o=String(t.code),a=l(t),{language:n,region:i}=u(a);n&&i&&s.get(n)===o&&!g.has(n)&&(g.add(n),c.push({hreflang:n,localeCode:o})),g.has(a)||(g.add(a),c.push({hreflang:a,localeCode:o}))}return c}exports.resolveHreflangAlternates=d;

package/dist/resolve-hreflang.d.cts

@@ -0,0 +1,22 @@
+import { Locale } from '@i18n-micro/types';
+export type HreflangLocaleInput = Pick<Locale, 'code' | 'iso'>;
+export interface ResolveHreflangAlternatesOptions {
+    /**
+     * Also emit a bare-language `hreflang` derived from `iso` (e.g. `es-ES` → `es`),
+     * claimed by the first regional locale in the list for that language.
+     * Never derived from routing `code`.
+     * @default false
+     */
+    hreflangBaseLanguage?: boolean;
+}
+export interface HreflangAlternate {
+    /** Value for the `hreflang` attribute (BCP-47 / `iso || code`). */
+    hreflang: string;
+    /** Locale `code` whose localized URL should back this tag. */
+    localeCode: string;
+}
+/**
+ * Resolve `hreflang` values for SEO alternate links.
+ * Uses `iso || code` — never emits routing `code` when `iso` is set (#243).
+ */
+export declare function resolveHreflangAlternates(locales: HreflangLocaleInput[], options?: ResolveHreflangAlternatesOptions): HreflangAlternate[];

package/dist/resolve-hreflang.d.ts

@@ -0,0 +1,22 @@
+import { Locale } from '@i18n-micro/types';
+export type HreflangLocaleInput = Pick<Locale, 'code' | 'iso'>;
+export interface ResolveHreflangAlternatesOptions {
+    /**
+     * Also emit a bare-language `hreflang` derived from `iso` (e.g. `es-ES` → `es`),
+     * claimed by the first regional locale in the list for that language.
+     * Never derived from routing `code`.
+     * @default false
+     */
+    hreflangBaseLanguage?: boolean;
+}
+export interface HreflangAlternate {
+    /** Value for the `hreflang` attribute (BCP-47 / `iso || code`). */
+    hreflang: string;
+    /** Locale `code` whose localized URL should back this tag. */
+    localeCode: string;
+}
+/**
+ * Resolve `hreflang` values for SEO alternate links.
+ * Uses `iso || code` — never emits routing `code` when `iso` is set (#243).
+ */
+export declare function resolveHreflangAlternates(locales: HreflangLocaleInput[], options?: ResolveHreflangAlternatesOptions): HreflangAlternate[];

package/dist/resolve-hreflang.mjs

@@ -0,0 +1,29 @@
+function u(n) {
+  return n.iso?.trim() || String(n.code);
+}
+function f(n) {
+  const r = n.match(/^([A-Za-z]{2,3})(?:[-_](.+))?$/);
+  return r ? { language: r[1], region: r[2] } : { language: n };
+}
+function d(n, r = {}) {
+  const { hreflangBaseLanguage: l = !1 } = r;
+  if (!l)
+    return n.map((o) => {
+      const t = String(o.code);
+      return { hreflang: u(o), localeCode: t };
+    });
+  const g = /* @__PURE__ */ new Map();
+  for (const o of n) {
+    const t = String(o.code), a = u(o), { language: e, region: i } = f(a);
+    e && i && !g.has(e) && g.set(e, t), g.set(a, t);
+  }
+  const s = /* @__PURE__ */ new Set(), c = [];
+  for (const o of n) {
+    const t = String(o.code), a = u(o), { language: e, region: i } = f(a);
+    e && i && g.get(e) === t && !s.has(e) && (s.add(e), c.push({ hreflang: e, localeCode: t })), s.has(a) || (s.add(a), c.push({ hreflang: a, localeCode: t }));
+  }
+  return c;
+}
+export {
+  d as resolveHreflangAlternates
+};

package/dist/split-locale-routes.cjs

@@ -0,0 +1 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});function a(s){const o=[],n={},r=new Set;for(const t of s){const e=t.name?.trim();if(!e)throw new Error("[splitLocaleRoutes] each entry needs a non-empty `name`");if(!t.path)throw new Error(`[splitLocaleRoutes] entry "${e}" needs a \`path\``);if(!t.file)throw new Error(`[splitLocaleRoutes] entry "${e}" needs a \`file\``);if(r.has(e))throw new Error(`[splitLocaleRoutes] duplicate route name "${e}"`);r.add(e),o.push({name:e,path:t.path,file:t.file}),t.paths!==void 0&&(n[e]=t.paths)}return{pages:o,globalLocaleRoutes:n}}exports.splitLocaleRoutes=a;

package/dist/split-locale-routes.d.cts

@@ -0,0 +1,36 @@
+import { GlobalLocaleRoutes, LocaleCode } from '@i18n-micro/types';
+/**
+ * One programmatic route entry for {@link splitLocaleRoutes} (#244).
+ * Prefer route `name` as the `globalLocaleRoutes` key so shared wrapper SFCs do not collapse.
+ */
+export interface SplitLocaleRouteEntry {
+    /** Route name — also the key in `globalLocaleRoutes`. */
+    name: string;
+    /** Default (unlocalized) path pushed into `pages:extend`. */
+    path: string;
+    /** Page component / wrapper SFC (Nuxt `file`). */
+    file: string;
+    /**
+     * Custom per-locale paths, or `false` to disable localization for this route.
+     * Omitted → route is still pushed to `pages`, but no `globalLocaleRoutes` entry.
+     */
+    paths?: Record<LocaleCode, string> | false;
+}
+export interface SplitLocaleRoutePage {
+    name: string;
+    path: string;
+    file: string;
+}
+export interface SplitLocaleRoutesResult {
+    /** Pass into `pages:extend`: `pages.push(...pages)`. */
+    pages: SplitLocaleRoutePage[];
+    /** Merge into `i18n.globalLocaleRoutes` (keyed by route name). */
+    globalLocaleRoutes: NonNullable<GlobalLocaleRoutes>;
+}
+/**
+ * Split one programmatic route registry into Nuxt pages + `globalLocaleRoutes` (#244).
+ *
+ * Keeps both halves in sync and keys locale paths by route **name** (not file path),
+ * so N routes sharing one wrapper SFC do not overwrite each other.
+ */
+export declare function splitLocaleRoutes(entries: readonly SplitLocaleRouteEntry[]): SplitLocaleRoutesResult;

package/dist/split-locale-routes.d.ts

@@ -0,0 +1,36 @@
+import { GlobalLocaleRoutes, LocaleCode } from '@i18n-micro/types';
+/**
+ * One programmatic route entry for {@link splitLocaleRoutes} (#244).
+ * Prefer route `name` as the `globalLocaleRoutes` key so shared wrapper SFCs do not collapse.
+ */
+export interface SplitLocaleRouteEntry {
+    /** Route name — also the key in `globalLocaleRoutes`. */
+    name: string;
+    /** Default (unlocalized) path pushed into `pages:extend`. */
+    path: string;
+    /** Page component / wrapper SFC (Nuxt `file`). */
+    file: string;
+    /**
+     * Custom per-locale paths, or `false` to disable localization for this route.
+     * Omitted → route is still pushed to `pages`, but no `globalLocaleRoutes` entry.
+     */
+    paths?: Record<LocaleCode, string> | false;
+}
+export interface SplitLocaleRoutePage {
+    name: string;
+    path: string;
+    file: string;
+}
+export interface SplitLocaleRoutesResult {
+    /** Pass into `pages:extend`: `pages.push(...pages)`. */
+    pages: SplitLocaleRoutePage[];
+    /** Merge into `i18n.globalLocaleRoutes` (keyed by route name). */
+    globalLocaleRoutes: NonNullable<GlobalLocaleRoutes>;
+}
+/**
+ * Split one programmatic route registry into Nuxt pages + `globalLocaleRoutes` (#244).
+ *
+ * Keeps both halves in sync and keys locale paths by route **name** (not file path),
+ * so N routes sharing one wrapper SFC do not overwrite each other.
+ */
+export declare function splitLocaleRoutes(entries: readonly SplitLocaleRouteEntry[]): SplitLocaleRoutesResult;

package/dist/split-locale-routes.mjs

@@ -0,0 +1,19 @@
+function s(a) {
+  const o = [], n = {}, r = /* @__PURE__ */ new Set();
+  for (const t of a) {
+    const e = t.name?.trim();
+    if (!e)
+      throw new Error("[splitLocaleRoutes] each entry needs a non-empty `name`");
+    if (!t.path)
+      throw new Error(`[splitLocaleRoutes] entry "${e}" needs a \`path\``);
+    if (!t.file)
+      throw new Error(`[splitLocaleRoutes] entry "${e}" needs a \`file\``);
+    if (r.has(e))
+      throw new Error(`[splitLocaleRoutes] duplicate route name "${e}"`);
+    r.add(e), o.push({ name: e, path: t.path, file: t.file }), t.paths !== void 0 && (n[e] = t.paths);
+  }
+  return { pages: o, globalLocaleRoutes: n };
+}
+export {
+  s as splitLocaleRoutes
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@i18n-micro/utils",
-  "version": "1.0.11",
+  "version": "1.0.13",
   "description": "Framework-agnostic utilities for Nuxt I18n Micro (granular subpath imports).",
   "keywords": [
     "i18n",
@@ -165,6 +165,36 @@
       },
       "default": "./dist/resolve-locale.mjs"
     },
+    "./auto-detect-path": {
+      "production": {
+        "types": "./dist/auto-detect-path.d.ts",
+        "default": "./dist/auto-detect-path.mjs"
+      },
+      "import": {
+        "types": "./dist/auto-detect-path.d.ts",
+        "default": "./dist/auto-detect-path.mjs"
+      },
+      "require": {
+        "types": "./dist/auto-detect-path.d.cts",
+        "default": "./dist/auto-detect-path.cjs"
+      },
+      "default": "./dist/auto-detect-path.mjs"
+    },
+    "./split-locale-routes": {
+      "production": {
+        "types": "./dist/split-locale-routes.d.ts",
+        "default": "./dist/split-locale-routes.mjs"
+      },
+      "import": {
+        "types": "./dist/split-locale-routes.d.ts",
+        "default": "./dist/split-locale-routes.mjs"
+      },
+      "require": {
+        "types": "./dist/split-locale-routes.d.cts",
+        "default": "./dist/split-locale-routes.cjs"
+      },
+      "default": "./dist/split-locale-routes.mjs"
+    },
     "./resolve-og-locale": {
       "production": {
         "types": "./dist/resolve-og-locale.d.ts",
@@ -180,6 +210,21 @@
       },
       "default": "./dist/resolve-og-locale.mjs"
     },
+    "./resolve-hreflang": {
+      "production": {
+        "types": "./dist/resolve-hreflang.d.ts",
+        "default": "./dist/resolve-hreflang.mjs"
+      },
+      "import": {
+        "types": "./dist/resolve-hreflang.d.ts",
+        "default": "./dist/resolve-hreflang.mjs"
+      },
+      "require": {
+        "types": "./dist/resolve-hreflang.d.cts",
+        "default": "./dist/resolve-hreflang.cjs"
+      },
+      "default": "./dist/resolve-hreflang.mjs"
+    },
     "./merge-i18n-head": {
       "production": {
         "types": "./dist/merge-i18n-head.d.ts",
@@ -353,14 +398,14 @@
   },
   "dependencies": {
     "globby": "^14.1.0",
-    "@i18n-micro/types": "1.2.8"
+    "@i18n-micro/types": "^1.2.10"
   },
   "devDependencies": {
     "publint": "^0.3.17",
     "vite": "^7.3.6",
     "vite-plugin-dts": "^4.5.4",
     "vitest": "^4.1.10",
-    "@i18n-micro/test-utils": "1.2.6"
+    "@i18n-micro/test-utils": "^1.2.8"
   },
   "engines": {
     "node": ">=18"