@i18n-micro/utils 1.0.1 → 1.0.3

package/README.md

@@ -9,6 +9,9 @@ import { findAllowedLocalesForRoute } from '@i18n-micro/utils/route'
 import { extractBaseRoutePattern } from '@i18n-micro/utils/route-pattern'
 import { resolveI18nConfigWithRuntimeOverrides } from '@i18n-micro/utils/runtime-config'
 import { preMergeLocales } from '@i18n-micro/utils/build'
+import { mergeI18nHead } from '@i18n-micro/utils/merge-i18n-head'
 ```
 
+`mergeI18nHead` merges `useLocaleHead` output with page-level overrides (`I18nHeadInput`). Used by the `02.meta` plugin; import it directly for custom tooling or unit tests that need the same merge rules (replace hreflang/canonical/og, disable groups, append meta/link).
+
 No Vue, Nuxt, or Nitro dependencies. `sideEffects: false` for tree-shaking friendly bundlers.

package/dist/merge-i18n-head.cjs

@@ -0,0 +1 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const d=require("./resolve-og-locale.cjs");function u(e){return e.rel==="alternate"}function s(e){return e.rel==="alternate"&&e.hreflang==="x-default"}function m(e){return e.rel==="alternate"&&e.hreflang!=="x-default"}function g(e,t){const n=e[t];return n?`id:${n}`:e.property?`property:${e.property}`:e.name?`name:${e.name}`:`meta:${JSON.stringify(e)}`}function A(e,t){const n=e[t];return n?`id:${n}`:`link:${e.rel}:${e.hreflang??""}`}function p(e,t){const n=new Set([A(e,t)]);return e.rel==="alternate"&&e.hreflang&&n.add(`link:${e.rel}:${e.hreflang}`),e.rel==="canonical"&&n.add("link:canonical:"),[...n]}function $(e,t,n){if(g(e,n)===g(t,n)||t.property&&e.property===t.property||t.name&&e.name===t.name)return!0;const o=t[n];return!!(o&&e[n]===o)}function L(e,t,n){const o=e.filter(i=>!$(i,t,n));return o.push(t),o}function k(e,t,n){const o=new Set(p(t,n)),i=e.filter(c=>!p(c,n).some(l=>o.has(l)));return i.push(t),i}function x(e,t,n){let o=!1;const i=e.map(c=>c.rel!=="canonical"?c:(o=!0,{...c,href:t}));return o||i.unshift({[n]:"i18n-can",rel:"canonical",href:t}),i}function h(e,t,n,o,i){const c=e.filter(l=>l.property!==t);return c.push({[o]:t==="og:locale"?"i18n-og":t==="og:url"?"i18n-og-url":`i18n-page-${t}`,property:t,content:n}),c}function S(e,t,n,o){const i=[];for(const c of e){if(n&&c===n)continue;const l=t.find(f=>f.code===c);if(!l)continue;const a=d.resolveOgLocale(l);a&&i.push({[o]:`i18n-og-alt-${a}`,property:"og:locale:alternate",content:a})}return i}function M(e,t,n={}){if(!t)return{htmlAttrs:{...e.htmlAttrs},meta:[...e.meta],link:[...e.link]};const o=n.identifierAttribute??"id",i=new Set(t.disable??[]);let c={...e.htmlAttrs},l=[...e.meta],a=[...e.link];i.has("html")&&(c={}),i.has("hreflang")&&(a=a.filter(r=>!m(r))),i.has("x-default")&&(a=a.filter(r=>!s(r))),i.has("canonical")&&(a=a.filter(r=>r.rel!=="canonical")),i.has("og")&&(l=l.filter(r=>r.property!=="og:locale"&&r.property!=="og:url")),i.has("og-alternates")&&(l=l.filter(r=>r.property!=="og:locale:alternate"));const f=t.replace;if(f){if(f.canonical===!1?a=a.filter(r=>r.rel!=="canonical"):typeof f.canonical=="string"&&(a=x(a,f.canonical,o)),f.hreflang===!1?a=a.filter(r=>!u(r)):Array.isArray(f.hreflang)&&(a=a.filter(r=>!u(r)),a.push(...f.hreflang)),f.xDefault===!1?a=a.filter(r=>!s(r)):f.xDefault&&(a=a.filter(r=>!s(r)),a.push(f.xDefault)),f.ogLocale===!1?l=l.filter(r=>r.property!=="og:locale"):typeof f.ogLocale=="string"&&(l=h(l,"og:locale",f.ogLocale,o)),f.ogUrl===!1?l=l.filter(r=>r.property!=="og:url"):typeof f.ogUrl=="string"&&(l=h(l,"og:url",f.ogUrl,o)),f.ogAlternates===!1)l=l.filter(r=>r.property!=="og:locale:alternate");else if(Array.isArray(f.ogAlternates)){l=l.filter(y=>y.property!=="og:locale:alternate");const r=n.locales??[];l.push(...S(f.ogAlternates,r,n.currentLocale,o))}}t.htmlAttrs&&(c={...c,...t.htmlAttrs});for(const r of t.meta??[])l=L(l,r,o);for(const r of t.link??[])a=k(a,r,o);return{htmlAttrs:c,meta:l,link:a}}exports.mergeI18nHead=M;

package/dist/merge-i18n-head.d.cts

@@ -0,0 +1,12 @@
+import { I18nHeadInput, I18nHeadLink, I18nHeadMeta, Locale } from '@i18n-micro/types';
+export interface I18nHeadObject {
+    htmlAttrs: Record<string, string | undefined>;
+    meta: I18nHeadMeta[];
+    link: I18nHeadLink[];
+}
+export interface MergeI18nHeadOptions {
+    identifierAttribute?: string;
+    locales?: Locale[];
+    currentLocale?: string;
+}
+export declare function mergeI18nHead(base: I18nHeadObject, override: I18nHeadInput | null | undefined, options?: MergeI18nHeadOptions): I18nHeadObject;

package/dist/merge-i18n-head.d.ts

@@ -0,0 +1,12 @@
+import { I18nHeadInput, I18nHeadLink, I18nHeadMeta, Locale } from '@i18n-micro/types';
+export interface I18nHeadObject {
+    htmlAttrs: Record<string, string | undefined>;
+    meta: I18nHeadMeta[];
+    link: I18nHeadLink[];
+}
+export interface MergeI18nHeadOptions {
+    identifierAttribute?: string;
+    locales?: Locale[];
+    currentLocale?: string;
+}
+export declare function mergeI18nHead(base: I18nHeadObject, override: I18nHeadInput | null | undefined, options?: MergeI18nHeadOptions): I18nHeadObject;

package/dist/merge-i18n-head.mjs

@@ -0,0 +1,97 @@
+import { resolveOgLocale as d } from "./resolve-og-locale.mjs";
+function u(e) {
+  return e.rel === "alternate";
+}
+function s(e) {
+  return e.rel === "alternate" && e.hreflang === "x-default";
+}
+function m(e) {
+  return e.rel === "alternate" && e.hreflang !== "x-default";
+}
+function p(e, t) {
+  const n = e[t];
+  return n ? `id:${n}` : e.property ? `property:${e.property}` : e.name ? `name:${e.name}` : `meta:${JSON.stringify(e)}`;
+}
+function A(e, t) {
+  const n = e[t];
+  return n ? `id:${n}` : `link:${e.rel}:${e.hreflang ?? ""}`;
+}
+function g(e, t) {
+  const n = /* @__PURE__ */ new Set([A(e, t)]);
+  return e.rel === "alternate" && e.hreflang && n.add(`link:${e.rel}:${e.hreflang}`), e.rel === "canonical" && n.add("link:canonical:"), [...n];
+}
+function $(e, t, n) {
+  if (p(e, n) === p(t, n) || t.property && e.property === t.property || t.name && e.name === t.name) return !0;
+  const o = t[n];
+  return !!(o && e[n] === o);
+}
+function L(e, t, n) {
+  const o = e.filter((i) => !$(i, t, n));
+  return o.push(t), o;
+}
+function x(e, t, n) {
+  const o = new Set(g(t, n)), i = e.filter((c) => !g(c, n).some((l) => o.has(l)));
+  return i.push(t), i;
+}
+function k(e, t, n) {
+  let o = !1;
+  const i = e.map((c) => c.rel !== "canonical" ? c : (o = !0, { ...c, href: t }));
+  return o || i.unshift({
+    [n]: "i18n-can",
+    rel: "canonical",
+    href: t
+  }), i;
+}
+function h(e, t, n, o, i) {
+  const c = e.filter((l) => l.property !== t);
+  return c.push({
+    [o]: t === "og:locale" ? "i18n-og" : t === "og:url" ? "i18n-og-url" : `i18n-page-${t}`,
+    property: t,
+    content: n
+  }), c;
+}
+function D(e, t, n, o) {
+  const i = [];
+  for (const c of e) {
+    if (n && c === n) continue;
+    const l = t.find((f) => f.code === c);
+    if (!l) continue;
+    const a = d(l);
+    a && i.push({
+      [o]: `i18n-og-alt-${a}`,
+      property: "og:locale:alternate",
+      content: a
+    });
+  }
+  return i;
+}
+function S(e, t, n = {}) {
+  if (!t)
+    return {
+      htmlAttrs: { ...e.htmlAttrs },
+      meta: [...e.meta],
+      link: [...e.link]
+    };
+  const o = n.identifierAttribute ?? "id", i = new Set(t.disable ?? []);
+  let c = { ...e.htmlAttrs }, l = [...e.meta], a = [...e.link];
+  i.has("html") && (c = {}), i.has("hreflang") && (a = a.filter((r) => !m(r))), i.has("x-default") && (a = a.filter((r) => !s(r))), i.has("canonical") && (a = a.filter((r) => r.rel !== "canonical")), i.has("og") && (l = l.filter((r) => r.property !== "og:locale" && r.property !== "og:url")), i.has("og-alternates") && (l = l.filter((r) => r.property !== "og:locale:alternate"));
+  const f = t.replace;
+  if (f) {
+    if (f.canonical === !1 ? a = a.filter((r) => r.rel !== "canonical") : typeof f.canonical == "string" && (a = k(a, f.canonical, o)), f.hreflang === !1 ? a = a.filter((r) => !u(r)) : Array.isArray(f.hreflang) && (a = a.filter((r) => !u(r)), a.push(...f.hreflang)), f.xDefault === !1 ? a = a.filter((r) => !s(r)) : f.xDefault && (a = a.filter((r) => !s(r)), a.push(f.xDefault)), f.ogLocale === !1 ? l = l.filter((r) => r.property !== "og:locale") : typeof f.ogLocale == "string" && (l = h(l, "og:locale", f.ogLocale, o)), f.ogUrl === !1 ? l = l.filter((r) => r.property !== "og:url") : typeof f.ogUrl == "string" && (l = h(l, "og:url", f.ogUrl, o)), f.ogAlternates === !1)
+      l = l.filter((r) => r.property !== "og:locale:alternate");
+    else if (Array.isArray(f.ogAlternates)) {
+      l = l.filter((y) => y.property !== "og:locale:alternate");
+      const r = n.locales ?? [];
+      l.push(...D(f.ogAlternates, r, n.currentLocale, o));
+    }
+  }
+  t.htmlAttrs && (c = { ...c, ...t.htmlAttrs });
+  for (const r of t.meta ?? [])
+    l = L(l, r, o);
+  for (const r of t.link ?? [])
+    a = x(a, r, o);
+  return { htmlAttrs: c, meta: l, link: a };
+}
+export {
+  S as mergeI18nHead
+};

package/dist/resolve-og-locale.cjs

@@ -0,0 +1 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});function c(n){const t=n.og?.trim();if(t)return t;const e=n.iso?.trim();if(!e)return null;const r=e.indexOf("_");if(r>0){const s=e.slice(0,r),o=e.slice(r+1);if(s.length>=2&&o.length===2)return`${s.toLowerCase()}_${o.toUpperCase()}`}const i=e.indexOf("-");if(i>0){const s=e.slice(0,i),o=e.slice(i+1);if(s.length>=2&&o.length===2&&/^[A-Za-z]{2}$/.test(o))return`${s.toLowerCase()}_${o.toUpperCase()}`}return null}function l(n,t={}){if(c(n)!==null||t.missingWarn===!1||process.env.NODE_ENV==="production")return;const e=t.tag??"og:locale",r=String(n.code??"unknown"),i=n.iso?`, iso: '${n.iso}'`:"";console.warn(`[i18n] Cannot derive ${e} for locale '${r}'${i}. Set locale.og (e.g. 'en_US') or use iso with a 2-letter region (e.g. 'en-US').`)}exports.resolveOgLocale=c;exports.warnUnresolvedOgLocale=l;

package/dist/resolve-og-locale.d.cts

@@ -0,0 +1,17 @@
+import { Locale } from '@i18n-micro/types';
+type OgLocaleInput = Pick<Locale, 'og' | 'iso' | 'code'>;
+export interface WarnUnresolvedOgLocaleOptions {
+    /** When false, suppresses the warning (same flag as missing translation keys). */
+    missingWarn?: boolean;
+    tag?: 'og:locale' | 'og:locale:alternate';
+}
+/**
+ * Resolve Open Graph locale (`language_TERRITORY`, underscore) for `og:locale` meta tags.
+ * Returns null when the value cannot be determined safely — no tag should be emitted.
+ */
+export declare function resolveOgLocale(locale: OgLocaleInput): string | null;
+/**
+ * Log a dev-only hint when `og:locale` / `og:locale:alternate` cannot be derived.
+ */
+export declare function warnUnresolvedOgLocale(locale: OgLocaleInput, options?: WarnUnresolvedOgLocaleOptions): void;
+export {};

package/dist/resolve-og-locale.d.ts

@@ -0,0 +1,17 @@
+import { Locale } from '@i18n-micro/types';
+type OgLocaleInput = Pick<Locale, 'og' | 'iso' | 'code'>;
+export interface WarnUnresolvedOgLocaleOptions {
+    /** When false, suppresses the warning (same flag as missing translation keys). */
+    missingWarn?: boolean;
+    tag?: 'og:locale' | 'og:locale:alternate';
+}
+/**
+ * Resolve Open Graph locale (`language_TERRITORY`, underscore) for `og:locale` meta tags.
+ * Returns null when the value cannot be determined safely — no tag should be emitted.
+ */
+export declare function resolveOgLocale(locale: OgLocaleInput): string | null;
+/**
+ * Log a dev-only hint when `og:locale` / `og:locale:alternate` cannot be derived.
+ */
+export declare function warnUnresolvedOgLocale(locale: OgLocaleInput, options?: WarnUnresolvedOgLocaleOptions): void;
+export {};

package/dist/resolve-og-locale.mjs

@@ -0,0 +1,30 @@
+function c(n) {
+  const t = n.og?.trim();
+  if (t) return t;
+  const e = n.iso?.trim();
+  if (!e) return null;
+  const r = e.indexOf("_");
+  if (r > 0) {
+    const s = e.slice(0, r), o = e.slice(r + 1);
+    if (s.length >= 2 && o.length === 2)
+      return `${s.toLowerCase()}_${o.toUpperCase()}`;
+  }
+  const i = e.indexOf("-");
+  if (i > 0) {
+    const s = e.slice(0, i), o = e.slice(i + 1);
+    if (s.length >= 2 && o.length === 2 && /^[A-Za-z]{2}$/.test(o))
+      return `${s.toLowerCase()}_${o.toUpperCase()}`;
+  }
+  return null;
+}
+function l(n, t = {}) {
+  if (c(n) !== null || t.missingWarn === !1 || process.env.NODE_ENV === "production") return;
+  const e = t.tag ?? "og:locale", r = String(n.code ?? "unknown"), i = n.iso ? `, iso: '${n.iso}'` : "";
+  console.warn(
+    `[i18n] Cannot derive ${e} for locale '${r}'${i}. Set locale.og (e.g. 'en_US') or use iso with a 2-letter region (e.g. 'en-US').`
+  );
+}
+export {
+  c as resolveOgLocale,
+  l as warnUnresolvedOgLocale
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@i18n-micro/utils",
-  "version": "1.0.1",
+  "version": "1.0.3",
   "description": "Framework-agnostic utilities for Nuxt I18n Micro (granular subpath imports).",
   "keywords": [
     "i18n",
@@ -129,6 +129,28 @@
       },
       "default": "./dist/resolve-locale.mjs"
     },
+    "./resolve-og-locale": {
+      "import": {
+        "types": "./dist/resolve-og-locale.d.ts",
+        "default": "./dist/resolve-og-locale.mjs"
+      },
+      "require": {
+        "types": "./dist/resolve-og-locale.d.cts",
+        "default": "./dist/resolve-og-locale.cjs"
+      },
+      "default": "./dist/resolve-og-locale.mjs"
+    },
+    "./merge-i18n-head": {
+      "import": {
+        "types": "./dist/merge-i18n-head.d.ts",
+        "default": "./dist/merge-i18n-head.mjs"
+      },
+      "require": {
+        "types": "./dist/merge-i18n-head.d.cts",
+        "default": "./dist/merge-i18n-head.cjs"
+      },
+      "default": "./dist/merge-i18n-head.mjs"
+    },
     "./active-locales": {
       "import": {
         "types": "./dist/active-locales.d.ts",
@@ -236,7 +258,7 @@
   },
   "dependencies": {
     "globby": "^14.1.0",
-    "@i18n-micro/types": "1.2.4"
+    "@i18n-micro/types": "1.2.6"
   },
   "devDependencies": {
     "publint": "^0.3.17",