@i18n-micro/astro 1.0.1 → 1.2.0

package/src/utils.ts

@@ -0,0 +1,401 @@
+import type { AstroI18n } from './composer'
+import type { Params, Locale, CleanTranslation, TranslationKey, Translations } from '@i18n-micro/types'
+import type { AstroGlobal } from 'astro'
+import type { I18nRoutingStrategy } from './router/types'
+import './env.d'
+
+/**
+ * Get i18n instance from Astro context
+ */
+export function getI18n(astro: AstroGlobal): AstroI18n {
+  const i18n = astro.locals.i18n
+  if (!i18n) {
+    throw new Error('i18n instance not found. Make sure i18n middleware is configured.')
+  }
+  // eslint-disable-next-line @typescript-eslint/ban-ts-comment
+  // @ts-ignore
+  return i18n
+}
+
+/**
+ * Get current locale from Astro context
+ */
+export function getLocale(astro: AstroGlobal): string {
+  return astro.locals.locale || 'en'
+}
+
+/**
+ * Get default locale from Astro context
+ */
+export function getDefaultLocale(astro: AstroGlobal): string {
+  return astro.locals.defaultLocale || 'en'
+}
+
+/**
+ * Get all locales from Astro context
+ */
+export function getLocales(astro: AstroGlobal): Locale[] {
+  return astro.locals.locales || []
+}
+
+/**
+ * Get routing strategy from Astro locals
+ */
+function getRoutingStrategy(astro: AstroGlobal): I18nRoutingStrategy | null {
+  // eslint-disable-next-line @typescript-eslint/ban-ts-comment
+  // @ts-ignore
+  return (astro.locals.routingStrategy as I18nRoutingStrategy | undefined) || null
+}
+
+/**
+ * Use i18n in Astro pages/components
+ * Returns helper functions for translations
+ */
+export function useI18n(astro: AstroGlobal) {
+  const i18n = getI18n(astro)
+  const locale = getLocale(astro)
+  const defaultLocale = getDefaultLocale(astro)
+  const locales = getLocales(astro)
+  const localeCodes = locales.map(l => l.code)
+  const routingStrategy = getRoutingStrategy(astro)
+
+  return {
+    // Current locale
+    locale,
+    defaultLocale,
+    locales,
+
+    // Translation methods
+    t: (key: TranslationKey, params?: Params, defaultValue?: string | null, routeName?: string): CleanTranslation => {
+      return i18n.t(key, params, defaultValue, routeName)
+    },
+    ts: (key: TranslationKey, params?: Params, defaultValue?: string, routeName?: string): string => {
+      return i18n.ts(key, params, defaultValue, routeName)
+    },
+    tc: (key: TranslationKey, count: number | Params, defaultValue?: string): string => {
+      return i18n.tc(key, count, defaultValue)
+    },
+    tn: (value: number, options?: Intl.NumberFormatOptions): string => {
+      return i18n.tn(value, options)
+    },
+    td: (value: Date | number | string, options?: Intl.DateTimeFormatOptions): string => {
+      return i18n.td(value, options)
+    },
+    tdr: (value: Date | number | string, options?: Intl.RelativeTimeFormatOptions): string => {
+      return i18n.tdr(value, options)
+    },
+    has: (key: TranslationKey, routeName?: string): boolean => {
+      return i18n.has(key, routeName)
+    },
+
+    // Route management
+    getRoute: (): string => {
+      return i18n.getRoute()
+    },
+    getRouteName: (path?: string): string => {
+      const targetPath = path || astro.url.pathname
+      if (routingStrategy?.getRouteName) {
+        return routingStrategy.getRouteName(targetPath, localeCodes)
+      }
+      // Fallback: basic route name extraction
+      const cleanPath = targetPath.replace(/^\//, '').replace(/\/$/, '')
+      if (!cleanPath) return 'index'
+      const segments = cleanPath.split('/').filter(Boolean)
+      const firstSegment = segments[0]
+      if (firstSegment && localeCodes.includes(firstSegment)) {
+        segments.shift()
+      }
+      return segments.length === 0 ? 'index' : segments.join('-')
+    },
+    getLocaleFromPath: (path?: string): string => {
+      const targetPath = path || astro.url.pathname
+      if (routingStrategy?.getLocaleFromPath) {
+        return routingStrategy.getLocaleFromPath(targetPath, defaultLocale, localeCodes)
+      }
+      // Fallback: check first segment
+      const segments = targetPath.split('/').filter(Boolean)
+      const firstSegment = segments[0]
+      return (firstSegment && localeCodes.includes(firstSegment)) ? firstSegment : defaultLocale
+    },
+
+    // Path utilities
+    switchLocalePath: (newLocale: string): string => {
+      if (routingStrategy?.switchLocalePath) {
+        return routingStrategy.switchLocalePath(astro.url.pathname, newLocale, localeCodes, defaultLocale)
+      }
+      // Fallback: basic locale switching
+      const segments = astro.url.pathname.split('/').filter(Boolean)
+      const firstSegment = segments[0]
+      if (firstSegment && localeCodes.includes(firstSegment)) {
+        segments.shift()
+      }
+      if (newLocale !== defaultLocale) {
+        segments.unshift(newLocale)
+      }
+      return `/${segments.join('/')}`
+    },
+    localizePath: (path: string, targetLocale?: string): string => {
+      if (routingStrategy?.localizePath) {
+        return routingStrategy.localizePath(path, targetLocale || locale, localeCodes, defaultLocale)
+      }
+      // Fallback: basic localization
+      const cleanPath = path.replace(/^\//, '').replace(/\/$/, '') || ''
+      const segments = cleanPath.split('/').filter(Boolean)
+      const firstSegment = segments[0]
+      if (firstSegment && localeCodes.includes(firstSegment)) {
+        segments.shift()
+      }
+      if (targetLocale && targetLocale !== defaultLocale) {
+        segments.unshift(targetLocale)
+      }
+      return `/${segments.join('/')}`
+    },
+
+    // Get i18n instance
+    getI18n: (): AstroI18n => {
+      return i18n
+    },
+
+    // Get base path without locale (for rewrite)
+    getBasePath: (url?: URL): string => {
+      const targetUrl = url || astro.url
+      const pathname = targetUrl.pathname
+      const segments = pathname.split('/').filter(Boolean)
+
+      // Remove locale from path if present
+      const firstSegment = segments[0]
+      if (firstSegment && localeCodes.includes(firstSegment)) {
+        segments.shift()
+      }
+
+      const basePath = segments.length > 0 ? `/${segments.join('/')}` : '/'
+      return basePath
+    },
+
+    // Translation management
+    addTranslations: (locale: string, translations: Record<string, unknown>, merge: boolean = true): void => {
+      i18n.addTranslations(locale, translations, merge)
+    },
+    addRouteTranslations: (locale: string, routeName: string, translations: Record<string, unknown>, merge: boolean = true): void => {
+      i18n.addRouteTranslations(locale, routeName, translations, merge)
+    },
+    mergeTranslations: (locale: string, routeName: string, translations: Record<string, unknown>): void => {
+      i18n.mergeTranslations(locale, routeName, translations)
+    },
+    mergeGlobalTranslations: (locale: string, translations: Record<string, unknown>): void => {
+      i18n.mergeGlobalTranslations(locale, translations)
+    },
+    clearCache: (): void => {
+      i18n.clearCache()
+    },
+  }
+}
+
+/**
+ * Generate locale head meta tags for SEO
+ */
+export interface LocaleHeadOptions {
+  baseUrl?: string
+  addDirAttribute?: boolean
+  addSeoAttributes?: boolean
+}
+
+export interface LocaleHeadResult {
+  htmlAttrs: {
+    lang?: string
+    dir?: 'ltr' | 'rtl' | 'auto'
+  }
+  link: Array<{
+    rel: string
+    href: string
+    hreflang?: string
+  }>
+  meta: Array<{
+    property: string
+    content: string
+  }>
+}
+
+export function useLocaleHead(astro: AstroGlobal, options: LocaleHeadOptions = {}): LocaleHeadResult {
+  const {
+    baseUrl = '/',
+    addDirAttribute = true,
+    addSeoAttributes = true,
+  } = options
+
+  const locale = getLocale(astro)
+  const defaultLocale = getDefaultLocale(astro)
+  const locales = getLocales(astro)
+  const currentLocaleObj = locales.find(l => l.code === locale)
+
+  if (!currentLocaleObj) {
+    return { htmlAttrs: {}, link: [], meta: [] }
+  }
+
+  const currentIso = currentLocaleObj.iso || locale
+  const currentDir = currentLocaleObj.dir || 'auto'
+
+  const result: LocaleHeadResult = {
+    htmlAttrs: {
+      lang: currentIso,
+      ...(addDirAttribute ? { dir: currentDir } : {}),
+    },
+    link: [],
+    meta: [],
+  }
+
+  if (!addSeoAttributes) {
+    return result
+  }
+
+  // Canonical URL
+  const canonicalUrl = `${baseUrl}${astro.url.pathname}`
+  result.link.push({
+    rel: 'canonical',
+    href: canonicalUrl,
+  })
+
+  // Get routing strategy
+  const routingStrategy = getRoutingStrategy(astro)
+  const allLocaleCodes = locales.map(l => l.code)
+
+  // Alternate languages
+  for (const loc of locales) {
+    if (loc.code === locale) continue
+
+    let alternatePath = astro.url.pathname
+    if (routingStrategy?.switchLocalePath) {
+      alternatePath = routingStrategy.switchLocalePath(astro.url.pathname, loc.code, allLocaleCodes, defaultLocale)
+    }
+    else {
+      // Fallback: basic locale switching
+      const segments = astro.url.pathname.split('/').filter(Boolean)
+      const firstSegment = segments[0]
+      if (firstSegment && allLocaleCodes.includes(firstSegment)) {
+        segments.shift()
+      }
+      if (loc.code !== defaultLocale) {
+        segments.unshift(loc.code)
+      }
+      alternatePath = `/${segments.join('/')}`
+    }
+    const alternateUrl = `${baseUrl}${alternatePath}`
+
+    result.link.push({
+      rel: 'alternate',
+      href: alternateUrl,
+      hreflang: loc.code,
+    })
+
+    if (loc.iso && loc.iso !== loc.code) {
+      result.link.push({
+        rel: 'alternate',
+        href: alternateUrl,
+        hreflang: loc.iso,
+      })
+    }
+  }
+
+  // Open Graph locale
+  result.meta.push({
+    property: 'og:locale',
+    content: currentIso,
+  })
+
+  result.meta.push({
+    property: 'og:url',
+    content: canonicalUrl,
+  })
+
+  // Alternate OG locales
+  for (const loc of locales) {
+    if (loc.code === locale) continue
+    result.meta.push({
+      property: 'og:locale:alternate',
+      content: loc.iso || loc.code,
+    })
+  }
+
+  return result
+}
+
+/**
+ * Props для передачи в клиентские острова (Vue, React, Svelte, Preact)
+ */
+export interface I18nClientProps {
+  locale: string
+  fallbackLocale: string
+  translations: Record<string, Translations> // routeName -> translations
+  currentRoute: string
+}
+
+/**
+ * Создает вложенную структуру из ключа (например, 'islands.vue.title' -> { islands: { vue: { title: value } } })
+ */
+function setNestedValue(obj: Translations, key: string, value: unknown): void {
+  const parts = key.split('.')
+  let current: Translations = obj
+  for (let i = 0; i < parts.length - 1; i++) {
+    const part = parts[i]!
+    if (!current[part]) {
+      current[part] = {}
+    }
+    current = current[part] as Translations
+  }
+  const last = parts[parts.length - 1]
+  if (last !== undefined) {
+    current[last] = value
+  }
+}
+
+/**
+ * Подготавливает пропсы для передачи в клиентский остров.
+ * Принимает список ключей, которые нужно передать в остров.
+ * Использует методы i18n для правильной работы с routesLocaleLinks.
+ * currentRoute уже нормализован через middleware (getRouteName), поэтому используем его напрямую.
+ */
+export function getI18nProps(astro: AstroGlobal, keys?: string[]): I18nClientProps {
+  const i18n = getI18n(astro)
+  const locale = getLocale(astro)
+  const fallbackLocale = getDefaultLocale(astro)
+  // currentRoute уже нормализован через middleware.setRoute(getRouteName(...))
+  // getRouteName учитывает routesLocaleLinks, если они настроены
+  const currentRoute = i18n.getRoute()
+
+  const translations: Record<string, Translations> = {}
+
+  // Если указаны ключи, извлекаем только их из кэша
+  if (keys && keys.length > 0) {
+    const extracted: Translations = {}
+
+    // Используем методы i18n для получения переводов
+    // Это гарантирует правильную работу с routesLocaleLinks
+    for (const key of keys) {
+      // Используем i18n.t() который использует helper.getTranslation внутри
+      // и правильно резолвит ключ кэша с учетом routesLocaleLinks
+      const value = i18n.t(key, undefined, undefined, currentRoute)
+      if (value !== null && value !== undefined && value !== key) {
+        setNestedValue(extracted, key, value)
+      }
+    }
+
+    if (Object.keys(extracted).length > 0) {
+      translations[currentRoute] = extracted
+    }
+  }
+  else {
+    // Если ключи не указаны, берем route-specific переводы
+    // Используем публичный метод getRouteTranslations для безопасного доступа
+    const routeTrans = i18n.getRouteTranslations(locale, currentRoute)
+    if (routeTrans) {
+      translations[currentRoute] = routeTrans
+    }
+  }
+
+  return {
+    locale,
+    fallbackLocale,
+    currentRoute,
+    translations,
+  }
+}

package/dist/bridge/astro-bridge.d.ts

@@ -1,13 +0,0 @@
-import { I18nDevToolsBridge } from '@i18n-micro/devtools-ui';
-/**
- * Astro Toolbar Server interface (simplified)
- */
-export interface AstroToolbarServer {
-    send(event: string, data?: unknown): void;
-    on(event: string, callback: (data: unknown) => void): void;
-    off(event: string, callback: (data: unknown) => void): void;
-}
-/**
- * Create an Astro Toolbar bridge that adapts Astro Toolbar Server API to I18nDevToolsBridge interface
- */
-export declare function createAstroBridge(server: AstroToolbarServer): I18nDevToolsBridge;

package/dist/index-C-UMdqSG.cjs

@@ -1 +0,0 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const p=require("node:fs/promises"),u=require("node:path"),l=require("@i18n-micro/core");async function g(c,e=!1){const t={global:{},routes:{}};try{const a=await p.readdir(c,{recursive:!0,withFileTypes:!0});for(const o of a){if(!o.isFile()||!o.name.endsWith(".json"))continue;const r=u.join(o.path,o.name),s=u.relative(c,r).split(u.sep),i=u.basename(o.name,".json");try{const n=await p.readFile(r,"utf-8"),h=JSON.parse(n);if(!e&&s[0]==="pages"&&s.length>=2){const f=s.slice(1,-1);if(f.length>0){const d=f.join("-");t.routes[d]||(t.routes[d]={}),t.routes[d][i]=h}}else t.global[i]=h}catch(n){console.error(`Failed to load translation file ${r}:`,n)}}}catch(a){a&&typeof a=="object"&&"code"in a&&a.code!=="ENOENT"&&console.error(`Failed to read directory ${c}:`,a)}return t}class m{constructor(e){this.currentRoute="general",this.cache={generalLocaleCache:{},routeLocaleCache:{},dynamicTranslationsCaches:[],serverTranslationCache:{}},this.helper=l.useTranslationHelper(this.cache),this.formatter=new l.FormatService,this.locale=e.locale,this.fallbackLocale=e.fallbackLocale||e.locale,this.translationDir=e.translationDir,this.disablePageLocales=e.disablePageLocales??!1,this.pluralFunc=e.plural||l.defaultPlural,this.missingWarn=e.missingWarn??!1,this.missingHandler=e.missingHandler}setRoute(e){this.currentRoute=e}getRoute(){return this.currentRoute}t(e,t,a,o){if(!e)return"";const r=o||this.currentRoute;let s=this.helper.getTranslation(this.locale,r,e);return!s&&this.locale!==this.fallbackLocale&&(s=this.helper.getTranslation(this.fallbackLocale,r,e)),s||(this.missingHandler?this.missingHandler(this.locale,e,r):this.missingWarn&&console.warn(`[i18n] Translation key '${e}' not found for locale '${this.locale}' (route: '${r}').`),s=a===void 0?e:a||e),typeof s=="string"&&t?l.interpolate(s,t):s||e}ts(e,t,a,o){var r;return((r=this.t(e,t,a,o))==null?void 0:r.toString())??a??e}tc(e,t,a){const{count:o,...r}=typeof t=="number"?{count:t}:t;if(o===void 0)return a??e;const s=(i,n,h)=>this.t(i,n,h);return this.pluralFunc(e,Number.parseInt(o.toString()),r,this.locale,s)??a??e}tn(e,t){return this.formatter.formatNumber(e,this.locale,t)}td(e,t){return this.formatter.formatDate(e,this.locale,t)}tdr(e,t){return this.formatter.formatRelativeTime(e,this.locale,t)}async loadTranslations(e){const t=e||this.translationDir;if(!t){console.warn("[i18n-node] No translation directory specified");return}const{global:a,routes:o}=await g(t,this.disablePageLocales);for(const[r,s]of Object.entries(a))this.helper.mergeGlobalTranslation(r,s,!0);for(const[r,s]of Object.entries(o))for(const[i,n]of Object.entries(s))await this.helper.loadPageTranslations(i,r,n)}async reload(){this.helper.clearCache(),await this.loadTranslations(),console.log("[i18n-node] Cache cleared and translations reloaded.")}addTranslations(e,t,a=!0){a?this.helper.mergeGlobalTranslation(e,t,!0):this.helper.loadTranslations(e,t)}addRouteTranslations(e,t,a,o=!0){o?this.helper.mergeTranslation(e,t,a,!0):this.helper.loadPageTranslations(e,t,a)}hasTranslation(e){return this.helper.hasTranslation(this.locale,e)}clear(){this.helper.clearCache()}}Object.defineProperty(exports,"FormatService",{enumerable:!0,get:()=>l.FormatService});Object.defineProperty(exports,"interpolate",{enumerable:!0,get:()=>l.interpolate});exports.I18n=m;exports.loadTranslations=g;

package/dist/index-CVhedN6W.js

@@ -1,146 +0,0 @@
-import { readdir as d, readFile as f } from "node:fs/promises";
-import { join as m, relative as p, sep as g, basename as T } from "node:path";
-import { useTranslationHelper as b, FormatService as y, defaultPlural as j, interpolate as w } from "@i18n-micro/core";
-import { FormatService as k, interpolate as H } from "@i18n-micro/core";
-async function F(i, t = !1) {
-  const e = {
-    global: {},
-    routes: {}
-  };
-  try {
-    const a = await d(i, { recursive: !0, withFileTypes: !0 });
-    for (const o of a) {
-      if (!o.isFile() || !o.name.endsWith(".json"))
-        continue;
-      const r = m(o.path, o.name), s = p(i, r).split(g), n = T(o.name, ".json");
-      try {
-        const l = await f(r, "utf-8"), c = JSON.parse(l);
-        if (!t && s[0] === "pages" && s.length >= 2) {
-          const u = s.slice(1, -1);
-          if (u.length > 0) {
-            const h = u.join("-");
-            e.routes[h] || (e.routes[h] = {}), e.routes[h][n] = c;
-          }
-        } else
-          e.global[n] = c;
-      } catch (l) {
-        console.error(`Failed to load translation file ${r}:`, l);
-      }
-    }
-  } catch (a) {
-    a && typeof a == "object" && "code" in a && a.code !== "ENOENT" && console.error(`Failed to read directory ${i}:`, a);
-  }
-  return e;
-}
-class C {
-  constructor(t) {
-    this.currentRoute = "general", this.cache = {
-      generalLocaleCache: {},
-      routeLocaleCache: {},
-      dynamicTranslationsCaches: [],
-      serverTranslationCache: {}
-    }, this.helper = b(this.cache), this.formatter = new y(), this.locale = t.locale, this.fallbackLocale = t.fallbackLocale || t.locale, this.translationDir = t.translationDir, this.disablePageLocales = t.disablePageLocales ?? !1, this.pluralFunc = t.plural || j, this.missingWarn = t.missingWarn ?? !1, this.missingHandler = t.missingHandler;
-  }
-  /**
-   * Set the current route name context.
-   * Useful when processing a specific page request in Node.
-   */
-  setRoute(t) {
-    this.currentRoute = t;
-  }
-  getRoute() {
-    return this.currentRoute;
-  }
-  /**
-   * Get translation for a key
-   *
-   * Search order:
-   * 1. Current Locale + Current Route (Specific)
-   * 2. Current Locale + General (Global)
-   * 3. Fallback Locale + Current Route
-   * 4. Fallback Locale + General
-   */
-  t(t, e, a, o) {
-    if (!t) return "";
-    const r = o || this.currentRoute;
-    let s = this.helper.getTranslation(this.locale, r, t);
-    return !s && this.locale !== this.fallbackLocale && (s = this.helper.getTranslation(this.fallbackLocale, r, t)), s || (this.missingHandler ? this.missingHandler(this.locale, t, r) : this.missingWarn && console.warn(
-      `[i18n] Translation key '${t}' not found for locale '${this.locale}' (route: '${r}').`
-    ), s = a === void 0 ? t : a || t), typeof s == "string" && e ? w(s, e) : s || t;
-  }
-  /**
-   * Get translation as string
-   */
-  ts(t, e, a, o) {
-    var r;
-    return ((r = this.t(t, e, a, o)) == null ? void 0 : r.toString()) ?? a ?? t;
-  }
-  /**
-   * Plural translation
-   */
-  tc(t, e, a) {
-    const { count: o, ...r } = typeof e == "number" ? { count: e } : e;
-    if (o === void 0)
-      return a ?? t;
-    const s = (n, l, c) => this.t(n, l, c);
-    return this.pluralFunc(
-      t,
-      Number.parseInt(o.toString()),
-      r,
-      this.locale,
-      s
-    ) ?? a ?? t;
-  }
-  // --- Formatters ---
-  tn(t, e) {
-    return this.formatter.formatNumber(t, this.locale, e);
-  }
-  td(t, e) {
-    return this.formatter.formatDate(t, this.locale, e);
-  }
-  tdr(t, e) {
-    return this.formatter.formatRelativeTime(t, this.locale, e);
-  }
-  // --- Loader & Cache Management ---
-  /**
-   * Load translations from directory.
-   */
-  async loadTranslations(t) {
-    const e = t || this.translationDir;
-    if (!e) {
-      console.warn("[i18n-node] No translation directory specified");
-      return;
-    }
-    const { global: a, routes: o } = await F(e, this.disablePageLocales);
-    for (const [r, s] of Object.entries(a))
-      this.helper.mergeGlobalTranslation(r, s, !0);
-    for (const [r, s] of Object.entries(o))
-      for (const [n, l] of Object.entries(s))
-        await this.helper.loadPageTranslations(n, r, l);
-  }
-  /**
-   * Clear cache and reload translations from disk
-   */
-  async reload() {
-    this.helper.clearCache(), await this.loadTranslations(), console.log("[i18n-node] Cache cleared and translations reloaded.");
-  }
-  // --- Manual Manipulation ---
-  addTranslations(t, e, a = !0) {
-    a ? this.helper.mergeGlobalTranslation(t, e, !0) : this.helper.loadTranslations(t, e);
-  }
-  addRouteTranslations(t, e, a, o = !0) {
-    o ? this.helper.mergeTranslation(t, e, a, !0) : this.helper.loadPageTranslations(t, e, a);
-  }
-  hasTranslation(t) {
-    return this.helper.hasTranslation(this.locale, t);
-  }
-  clear() {
-    this.helper.clearCache();
-  }
-}
-export {
-  k as FormatService,
-  C as I18n,
-  H as interpolate,
-  F as loadTranslations
-};

package/dist/toolbar-app.d.ts

@@ -1,2 +0,0 @@
-declare const _default: import('astro').DevToolbarApp;
-export default _default;