@i18n-micro/utils 1.0.1 → 1.0.2

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.2",
   "description": "Framework-agnostic utilities for Nuxt I18n Micro (granular subpath imports).",
   "keywords": [
     "i18n",
@@ -129,6 +129,17 @@
       },
       "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"
+    },
     "./active-locales": {
       "import": {
         "types": "./dist/active-locales.d.ts",
@@ -236,7 +247,7 @@
   },
   "dependencies": {
     "globby": "^14.1.0",
-    "@i18n-micro/types": "1.2.4"
+    "@i18n-micro/types": "1.2.5"
   },
   "devDependencies": {
     "publint": "^0.3.17",