@jet-w/astro-blog 0.2.1 → 0.2.2

package/dist/index.d.ts

@@ -1,207 +1,15 @@
 export { defaultMenu, defaultSEO, defaultSiteConfig, defineMenu, defineSiteConfig, menu, siteConfig } from './config/index.js';
-import { b as SidebarConfig } from './sidebar-Da-W_4Lr.js';
-export { D as DividerConfig, M as ManualConfig, f as MixedConfig, P as PathMatchConfig, e as ScanConfig, a as SidebarGroup, S as SidebarItem, d as defaultSidebarConfig, c as defineSidebarConfig, s as sidebarConfig } from './sidebar-Da-W_4Lr.js';
-import { I as I18nConfig, L as Locale, F as FooterConfig, U as UITranslations, S as SocialLink } from './i18n-PgMCFBw0.js';
-export { m as FooterLink, o as I18nRoutingConfig, n as LocaleConfig, j as builtInTranslations, c as defaultFooterConfig, g as defaultI18nConfig, d as defaultIcons, l as defaultLocales, a as defaultSocialLinks, e as defineFooterConfig, h as defineI18nConfig, b as defineSocialLinks, k as enTranslations, f as footerConfig, i as getUITranslations, s as socialLinks, z as zhCNTranslations } from './i18n-PgMCFBw0.js';
-import { SiteConfig, NavigationItem } from './types/index.js';
-export { BlogPost, Category, PostFrontmatter, SEOProps, SearchResult, Tag } from './types/index.js';
+import { S as SidebarConfig } from './sidebar-DNdiCKBw.js';
+export { D as DividerConfig, M as ManualConfig, f as MixedConfig, P as PathMatchConfig, e as ScanConfig, b as SidebarGroup, c as SidebarItem, d as defaultSidebarConfig, a as defineSidebarConfig, s as sidebarConfig } from './sidebar-DNdiCKBw.js';
+import { F as FooterConfig, S as SocialLink, I as I18nConfig } from './i18n-DYYPTq4o.js';
+export { m as FooterLink, o as I18nRoutingConfig, L as Locale, n as LocaleConfig, U as UITranslations, j as builtInTranslations, c as defaultFooterConfig, g as defaultI18nConfig, d as defaultIcons, l as defaultLocales, a as defaultSocialLinks, e as defineFooterConfig, h as defineI18nConfig, b as defineSocialLinks, k as enTranslations, f as footerConfig, i as getUITranslations, s as socialLinks, z as zhCNTranslations } from './i18n-DYYPTq4o.js';
+import { SiteConfig } from './types/index.js';
+export { BlogPost, Category, NavigationItem, PostFrontmatter, SEOProps, SearchResult, Tag } from './types/index.js';
 export { AstroBlogIntegrationOptions, default as astroBlog, default as astroBlogIntegration } from './integration.js';
-import { ComputedRef } from 'vue';
+export { AlternateLink, MergedLocaleConfig, filterPostsByLocale, formatDate, formatDateShort, getAlternateLinks, getContentPathPrefix, getLocaleByCode, getLocaleConfig, getLocaleFromPath, getLocalePrefix, getLocalizedPath, getTextDirection, isMultiLanguageEnabled, isRTL, removeLocalePrefix, t } from './utils/i18n.js';
+export { I18N_CONFIG_KEY, I18N_LOCALE_KEY, I18N_TRANSLATIONS_KEY, I18nContext, UseI18nReturn, createI18nContext, useI18n } from './utils/useI18n.js';
 import 'astro';
-
-/**
- * i18n Utility Functions
- *
- * Provides helper functions for multi-language support.
- */
-
-/**
- * Merged locale configuration with all defaults applied
- */
-interface MergedLocaleConfig {
-    locale: Locale;
-    site: SiteConfig;
-    menu: NavigationItem[];
-    footer: FooterConfig;
-    sidebar: SidebarConfig;
-    ui: UITranslations;
-}
-/**
- * Alternate link for SEO (hreflang)
- */
-interface AlternateLink {
-    locale: string;
-    url: string;
-    hreflang: string;
-}
-/**
- * Get current locale from URL pathname
- *
- * @example
- * getLocaleFromPath('/en/posts', config) // 'en'
- * getLocaleFromPath('/posts', config) // 'zh-CN' (default)
- * getLocaleFromPath('/zh-CN/about', config) // 'zh-CN'
- */
-declare function getLocaleFromPath(pathname: string, config?: I18nConfig): string;
-/**
- * Get locale data by code
- */
-declare function getLocaleByCode(code: string, config?: I18nConfig): Locale | undefined;
-/**
- * Remove locale prefix from pathname
- *
- * @example
- * removeLocalePrefix('/en/posts', config) // '/posts'
- * removeLocalePrefix('/posts', config) // '/posts'
- */
-declare function removeLocalePrefix(pathname: string, config?: I18nConfig): string;
-/**
- * Get localized path for a given locale
- *
- * @example
- * getLocalizedPath('/posts', 'en', config) // '/en/posts'
- * getLocalizedPath('/en/posts', 'zh-CN', config) // '/posts' (if zh-CN is default)
- */
-declare function getLocalizedPath(pathname: string, targetLocale: string, config?: I18nConfig): string;
-/**
- * Get all alternate links for SEO (hreflang tags)
- *
- * @example
- * getAlternateLinks('/posts', 'https://example.com', config)
- * // Returns links for all locales
- */
-declare function getAlternateLinks(pathname: string, baseUrl: string, config?: I18nConfig): AlternateLink[];
-/**
- * Get merged configuration for a specific locale
- * Combines default config with locale-specific overrides
- */
-declare function getLocaleConfig(locale: string, config?: I18nConfig): MergedLocaleConfig;
-/**
- * Translation function - get a UI translation string
- *
- * @example
- * t('readMore', 'en') // 'Read more'
- * t('readMore', 'zh-CN') // '阅读更多'
- */
-declare function t(key: keyof UITranslations, locale: string, config?: I18nConfig): string;
-/**
- * Format date according to locale
- *
- * @example
- * formatDate(new Date(), 'en') // 'January 1, 2024'
- * formatDate(new Date(), 'zh-CN') // '2024年1月1日'
- */
-declare function formatDate(date: Date | string, locale: string, options?: Intl.DateTimeFormatOptions): string;
-/**
- * Format date in short format
- *
- * @example
- * formatDateShort(new Date(), 'en') // '1/1/2024'
- * formatDateShort(new Date(), 'zh-CN') // '2024/1/1'
- */
-declare function formatDateShort(date: Date | string, locale: string): string;
-/**
- * Check if a locale is RTL (right-to-left)
- */
-declare function isRTL(locale: string, config?: I18nConfig): boolean;
-/**
- * Get the HTML dir attribute value
- */
-declare function getTextDirection(locale: string, config?: I18nConfig): 'ltr' | 'rtl';
-/**
- * Check if multi-language is enabled (more than one locale)
- */
-declare function isMultiLanguageEnabled(config?: I18nConfig): boolean;
-/**
- * Get prefix for a locale in routes
- * Returns empty string for default locale if prefixDefaultLocale is false
- */
-declare function getLocalePrefix(locale: string, config?: I18nConfig): string;
-/**
- * Get content path prefix for a specific locale
- * Returns the contentPathPrefix from locale config, or undefined if not set
- */
-declare function getContentPathPrefix(locale: string, config?: I18nConfig): string | undefined;
-/**
- * Filter posts by locale based on contentPathPrefix
- * If contentPathPrefix is set, only return posts that start with that prefix
- * If not set, return all posts (backward compatible)
- *
- * @example
- * // If en locale has contentPathPrefix: 'blog_docs_en'
- * filterPostsByLocale(posts, 'en', config)
- * // Returns only posts with id starting with 'blog_docs_en/'
- */
-declare function filterPostsByLocale<T extends {
-    id: string;
-}>(posts: T[], locale: string, config?: I18nConfig): T[];
-
-/**
- * Vue Composable for i18n
- *
- * Provides i18n support for Vue components in the blog.
- */
-
-/**
- * i18n injection keys
- */
-declare const I18N_LOCALE_KEY: unique symbol;
-declare const I18N_CONFIG_KEY: unique symbol;
-declare const I18N_TRANSLATIONS_KEY: unique symbol;
-/**
- * i18n context provided to Vue components
- */
-interface I18nContext {
-    locale: string;
-    translations: UITranslations;
-    config?: I18nConfig;
-}
-/**
- * Return type of useI18n composable
- */
-interface UseI18nReturn {
-    /** Current locale code */
-    locale: ComputedRef<string>;
-    /** Translation function */
-    t: (key: keyof UITranslations) => string;
-    /** Format date according to locale */
-    formatDate: (date: Date | string, options?: Intl.DateTimeFormatOptions) => string;
-    /** Format date in short format */
-    formatDateShort: (date: Date | string) => string;
-    /** All translations for current locale */
-    translations: ComputedRef<UITranslations>;
-}
-/**
- * Vue composable for i18n support
- *
- * @example
- * ```vue
- * <script setup>
- * import { useI18n } from '@jet-w/astro-blog/utils/useI18n';
- *
- * const { t, formatDate, locale } = useI18n();
- * </script>
- *
- * <template>
- *   <h1>{{ t('postList') }}</h1>
- *   <span>{{ formatDate(post.pubDate) }}</span>
- * </template>
- * ```
- */
-declare function useI18n(): UseI18nReturn;
-/**
- * Create i18n context for providing to Vue components
- *
- * @example
- * ```astro
- * ---
- * import { createI18nContext } from '@jet-w/astro-blog/utils/useI18n';
- * const i18nContext = createI18nContext('en', i18nConfig);
- * ---
- * <Component client:load {...i18nContext} />
- * ```
- */
-declare function createI18nContext(locale: string, config?: I18nConfig): I18nContext;
+import 'vue';
 
 /**
  * Define blog configuration helper
@@ -232,4 +40,4 @@ declare function getAstroConfig(options?: {
     };
 };
 
-export { type AlternateLink, type BlogConfig, FooterConfig, I18N_CONFIG_KEY, I18N_LOCALE_KEY, I18N_TRANSLATIONS_KEY, I18nConfig, type I18nContext, Locale, type MergedLocaleConfig, NavigationItem, SidebarConfig, SiteConfig, SocialLink, UITranslations, type UseI18nReturn, createI18nContext, defineBlogConfig, filterPostsByLocale, formatDate, formatDateShort, getAlternateLinks, getAstroConfig, getContentPathPrefix, getLocaleByCode, getLocaleConfig, getLocaleFromPath, getLocalePrefix, getLocalizedPath, getTextDirection, isMultiLanguageEnabled, isRTL, removeLocalePrefix, t, useI18n };
+export { type BlogConfig, FooterConfig, I18nConfig, SidebarConfig, SiteConfig, SocialLink, defineBlogConfig, getAstroConfig };

package/dist/index.js

@@ -1,23 +1,49 @@
 import {
-  defaultFooterConfig,
   defaultIcons,
+  defaultSocialLinks,
+  defineSocialLinks,
+  socialLinks
+} from "./chunk-PG43JO4O.js";
+import "./chunk-FXPGR372.js";
+import {
+  filterPostsByLocale,
+  formatDate,
+  formatDateShort,
+  getAlternateLinks,
+  getContentPathPrefix,
+  getLocaleByCode,
+  getLocaleConfig,
+  getLocaleFromPath,
+  getLocalePrefix,
+  getLocalizedPath,
+  getTextDirection,
+  isMultiLanguageEnabled,
+  isRTL,
+  removeLocalePrefix,
+  t
+} from "./chunk-Z3O3JK56.js";
+import {
+  defaultFooterConfig,
   defaultMenu,
   defaultSEO,
   defaultSidebarConfig,
   defaultSiteConfig,
-  defaultSocialLinks,
   defineFooterConfig,
   defineMenu,
   defineSidebarConfig,
   defineSiteConfig,
-  defineSocialLinks,
   footerConfig,
   menu,
   sidebarConfig,
-  siteConfig,
-  socialLinks
-} from "./chunk-TJTPX2WP.js";
-import "./chunk-FXPGR372.js";
+  siteConfig
+} from "./chunk-DAH2XP4W.js";
+import {
+  I18N_CONFIG_KEY,
+  I18N_LOCALE_KEY,
+  I18N_TRANSLATIONS_KEY,
+  createI18nContext,
+  useI18n
+} from "./chunk-PZICDGJG.js";
 import {
   astroBlogIntegration,
   integration_default
@@ -32,222 +58,6 @@ import {
   zhCNTranslations
 } from "./chunk-A2E2VSAQ.js";
 
-// src/utils/i18n.ts
-function getLocaleFromPath(pathname, config = defaultI18nConfig) {
-  const segments = pathname.replace(/^\//, "").split("/");
-  const firstSegment = segments[0];
-  const matchedLocale = config.locales.find(
-    (locale) => locale.code === firstSegment
-  );
-  if (matchedLocale) {
-    return matchedLocale.code;
-  }
-  return config.defaultLocale;
-}
-function getLocaleByCode(code, config = defaultI18nConfig) {
-  return config.locales.find((locale) => locale.code === code);
-}
-function removeLocalePrefix(pathname, config = defaultI18nConfig) {
-  const locale = getLocaleFromPath(pathname, config);
-  if (locale === config.defaultLocale && !config.routing.prefixDefaultLocale) {
-    return pathname;
-  }
-  const prefix = `/${locale}`;
-  if (pathname.startsWith(prefix)) {
-    const rest = pathname.slice(prefix.length);
-    return rest || "/";
-  }
-  return pathname;
-}
-function getLocalizedPath(pathname, targetLocale, config = defaultI18nConfig) {
-  const basePath = removeLocalePrefix(pathname, config);
-  if (targetLocale === config.defaultLocale && !config.routing.prefixDefaultLocale) {
-    return basePath;
-  }
-  if (basePath === "/") {
-    return `/${targetLocale}`;
-  }
-  return `/${targetLocale}${basePath}`;
-}
-function getAlternateLinks(pathname, baseUrl, config = defaultI18nConfig) {
-  const links = [];
-  for (const locale of config.locales) {
-    const localizedPath = getLocalizedPath(pathname, locale.code, config);
-    links.push({
-      locale: locale.code,
-      url: `${baseUrl.replace(/\/$/, "")}${localizedPath}`,
-      hreflang: locale.htmlLang
-    });
-  }
-  const defaultPath = getLocalizedPath(
-    pathname,
-    config.defaultLocale,
-    config
-  );
-  links.push({
-    locale: "x-default",
-    url: `${baseUrl.replace(/\/$/, "")}${defaultPath}`,
-    hreflang: "x-default"
-  });
-  return links;
-}
-function deepMerge(base, override) {
-  const result = { ...base };
-  for (const key in override) {
-    if (Object.prototype.hasOwnProperty.call(override, key)) {
-      const overrideValue = override[key];
-      const baseValue = base[key];
-      if (typeof overrideValue === "object" && overrideValue !== null && !Array.isArray(overrideValue) && typeof baseValue === "object" && baseValue !== null && !Array.isArray(baseValue)) {
-        result[key] = deepMerge(baseValue, overrideValue);
-      } else if (overrideValue !== void 0) {
-        result[key] = overrideValue;
-      }
-    }
-  }
-  return result;
-}
-function getLocaleConfig(locale, config = defaultI18nConfig) {
-  const localeData = getLocaleByCode(locale, config);
-  const localeOverrides = config.localeConfigs[locale] || {};
-  const localeInfo = localeData || {
-    code: locale,
-    name: locale,
-    htmlLang: locale,
-    dateLocale: locale,
-    direction: "ltr"
-  };
-  const site = deepMerge(defaultSiteConfig, localeOverrides.site || {});
-  const menu2 = localeOverrides.menu || defaultMenu;
-  const footer = deepMerge(defaultFooterConfig, localeOverrides.footer || {});
-  const sidebar = localeOverrides.sidebar ? {
-    ...sidebarConfig,
-    ...localeOverrides.sidebar,
-    // Use locale-specific groups if provided, otherwise keep default
-    groups: localeOverrides.sidebar.groups || sidebarConfig.groups
-  } : sidebarConfig;
-  const ui = getUITranslations(locale, config);
-  return {
-    locale: localeInfo,
-    site,
-    menu: menu2,
-    footer,
-    sidebar,
-    ui
-  };
-}
-function t(key, locale, config) {
-  const translations = getUITranslations(locale, config);
-  return translations[key] || key;
-}
-function formatDate(date, locale, options) {
-  const dateObj = typeof date === "string" ? new Date(date) : date;
-  const defaultOptions = {
-    year: "numeric",
-    month: "long",
-    day: "numeric"
-  };
-  return new Intl.DateTimeFormat(locale, options || defaultOptions).format(
-    dateObj
-  );
-}
-function formatDateShort(date, locale) {
-  const dateObj = typeof date === "string" ? new Date(date) : date;
-  return new Intl.DateTimeFormat(locale, {
-    year: "numeric",
-    month: "numeric",
-    day: "numeric"
-  }).format(dateObj);
-}
-function isRTL(locale, config = defaultI18nConfig) {
-  const localeData = getLocaleByCode(locale, config);
-  return localeData?.direction === "rtl";
-}
-function getTextDirection(locale, config = defaultI18nConfig) {
-  return isRTL(locale, config) ? "rtl" : "ltr";
-}
-function isMultiLanguageEnabled(config = defaultI18nConfig) {
-  return config.locales.length > 1;
-}
-function getLocalePrefix(locale, config = defaultI18nConfig) {
-  if (locale === config.defaultLocale && !config.routing.prefixDefaultLocale) {
-    return "";
-  }
-  return `/${locale}`;
-}
-function getContentPathPrefix(locale, config = defaultI18nConfig) {
-  const localeConfig = config.localeConfigs[locale];
-  return localeConfig?.contentPathPrefix;
-}
-function filterPostsByLocale(posts, locale, config = defaultI18nConfig) {
-  const contentPathPrefix = getContentPathPrefix(locale, config);
-  if (!contentPathPrefix) {
-    return posts;
-  }
-  return posts.filter((post) => {
-    const postPath = post.id.toLowerCase();
-    const prefix = contentPathPrefix.toLowerCase();
-    return postPath.startsWith(prefix + "/") || postPath === prefix;
-  });
-}
-
-// src/utils/useI18n.ts
-import { inject, computed } from "vue";
-var I18N_LOCALE_KEY = /* @__PURE__ */ Symbol("i18n-locale");
-var I18N_CONFIG_KEY = /* @__PURE__ */ Symbol("i18n-config");
-var I18N_TRANSLATIONS_KEY = /* @__PURE__ */ Symbol("i18n-translations");
-function useI18n() {
-  const injectedLocale = inject(I18N_LOCALE_KEY, "zh-CN");
-  const injectedTranslations = inject(
-    I18N_TRANSLATIONS_KEY,
-    void 0
-  );
-  const injectedConfig = inject(I18N_CONFIG_KEY, void 0);
-  const locale = computed(() => injectedLocale);
-  const translations = computed(() => {
-    if (injectedTranslations) {
-      return injectedTranslations;
-    }
-    return getUITranslations(injectedLocale, injectedConfig);
-  });
-  function t2(key) {
-    return translations.value[key] || key;
-  }
-  function formatDate2(date, options) {
-    const dateObj = typeof date === "string" ? new Date(date) : date;
-    const defaultOptions = {
-      year: "numeric",
-      month: "long",
-      day: "numeric"
-    };
-    return new Intl.DateTimeFormat(
-      locale.value,
-      options || defaultOptions
-    ).format(dateObj);
-  }
-  function formatDateShort2(date) {
-    const dateObj = typeof date === "string" ? new Date(date) : date;
-    return new Intl.DateTimeFormat(locale.value, {
-      year: "numeric",
-      month: "numeric",
-      day: "numeric"
-    }).format(dateObj);
-  }
-  return {
-    locale,
-    t: t2,
-    formatDate: formatDate2,
-    formatDateShort: formatDateShort2,
-    translations
-  };
-}
-function createI18nContext(locale, config) {
-  return {
-    locale,
-    translations: getUITranslations(locale, config),
-    config
-  };
-}
-
 // src/index.ts
 function defineBlogConfig(config) {
   return config;

package/dist/integration.d.ts

@@ -1,7 +1,7 @@
 import { AstroIntegration } from 'astro';
-import { I as I18nConfig } from './i18n-PgMCFBw0.js';
+import { I as I18nConfig } from './i18n-DYYPTq4o.js';
 import './types/index.js';
-import './sidebar-Da-W_4Lr.js';
+import './sidebar-DNdiCKBw.js';
 
 /**
  * @jet-w/astro-blog Integration

package/dist/{sidebar-Da-W_4Lr.d.ts → sidebar-DNdiCKBw.d.ts}

@@ -89,4 +89,4 @@ declare const sidebarConfig: SidebarConfig;
 declare function defineSidebarConfig(config: Partial<SidebarConfig>): SidebarConfig;
 declare const defaultSidebarConfig: SidebarConfig;
 
-export { type DividerConfig as D, type ManualConfig as M, type PathMatchConfig as P, type SidebarItem as S, type SidebarGroup as a, type SidebarConfig as b, defineSidebarConfig as c, defaultSidebarConfig as d, type ScanConfig as e, type MixedConfig as f, sidebarConfig as s };
+export { type DividerConfig as D, type ManualConfig as M, type PathMatchConfig as P, type SidebarConfig as S, defineSidebarConfig as a, type SidebarGroup as b, type SidebarItem as c, defaultSidebarConfig as d, type ScanConfig as e, type MixedConfig as f, sidebarConfig as s };

package/dist/utils/i18n.d.ts

@@ -0,0 +1,133 @@
+import { I as I18nConfig, L as Locale, F as FooterConfig, U as UITranslations } from '../i18n-DYYPTq4o.js';
+export { n as LocaleConfig, j as builtInTranslations, g as defaultI18nConfig, h as defineI18nConfig, k as enTranslations, i as getUITranslations, z as zhCNTranslations } from '../i18n-DYYPTq4o.js';
+import { SiteConfig, NavigationItem } from '../types/index.js';
+import { S as SidebarConfig } from '../sidebar-DNdiCKBw.js';
+
+/**
+ * i18n Utility Functions
+ *
+ * Provides helper functions for multi-language support.
+ */
+
+/**
+ * Merged locale configuration with all defaults applied
+ */
+interface MergedLocaleConfig {
+    locale: Locale;
+    site: SiteConfig;
+    menu: NavigationItem[];
+    footer: FooterConfig;
+    sidebar: SidebarConfig;
+    ui: UITranslations;
+}
+/**
+ * Alternate link for SEO (hreflang)
+ */
+interface AlternateLink {
+    locale: string;
+    url: string;
+    hreflang: string;
+}
+/**
+ * Get current locale from URL pathname
+ *
+ * @example
+ * getLocaleFromPath('/en/posts', config) // 'en'
+ * getLocaleFromPath('/posts', config) // 'zh-CN' (default)
+ * getLocaleFromPath('/zh-CN/about', config) // 'zh-CN'
+ */
+declare function getLocaleFromPath(pathname: string, config?: I18nConfig): string;
+/**
+ * Get locale data by code
+ */
+declare function getLocaleByCode(code: string, config?: I18nConfig): Locale | undefined;
+/**
+ * Remove locale prefix from pathname
+ *
+ * @example
+ * removeLocalePrefix('/en/posts', config) // '/posts'
+ * removeLocalePrefix('/posts', config) // '/posts'
+ */
+declare function removeLocalePrefix(pathname: string, config?: I18nConfig): string;
+/**
+ * Get localized path for a given locale
+ *
+ * @example
+ * getLocalizedPath('/posts', 'en', config) // '/en/posts'
+ * getLocalizedPath('/en/posts', 'zh-CN', config) // '/posts' (if zh-CN is default)
+ */
+declare function getLocalizedPath(pathname: string, targetLocale: string, config?: I18nConfig): string;
+/**
+ * Get all alternate links for SEO (hreflang tags)
+ *
+ * @example
+ * getAlternateLinks('/posts', 'https://example.com', config)
+ * // Returns links for all locales
+ */
+declare function getAlternateLinks(pathname: string, baseUrl: string, config?: I18nConfig): AlternateLink[];
+/**
+ * Get merged configuration for a specific locale
+ * Combines default config with locale-specific overrides
+ */
+declare function getLocaleConfig(locale: string, config?: I18nConfig): MergedLocaleConfig;
+/**
+ * Translation function - get a UI translation string
+ *
+ * @example
+ * t('readMore', 'en') // 'Read more'
+ * t('readMore', 'zh-CN') // '阅读更多'
+ */
+declare function t(key: keyof UITranslations, locale: string, config?: I18nConfig): string;
+/**
+ * Format date according to locale
+ *
+ * @example
+ * formatDate(new Date(), 'en') // 'January 1, 2024'
+ * formatDate(new Date(), 'zh-CN') // '2024年1月1日'
+ */
+declare function formatDate(date: Date | string, locale: string, options?: Intl.DateTimeFormatOptions): string;
+/**
+ * Format date in short format
+ *
+ * @example
+ * formatDateShort(new Date(), 'en') // '1/1/2024'
+ * formatDateShort(new Date(), 'zh-CN') // '2024/1/1'
+ */
+declare function formatDateShort(date: Date | string, locale: string): string;
+/**
+ * Check if a locale is RTL (right-to-left)
+ */
+declare function isRTL(locale: string, config?: I18nConfig): boolean;
+/**
+ * Get the HTML dir attribute value
+ */
+declare function getTextDirection(locale: string, config?: I18nConfig): 'ltr' | 'rtl';
+/**
+ * Check if multi-language is enabled (more than one locale)
+ */
+declare function isMultiLanguageEnabled(config?: I18nConfig): boolean;
+/**
+ * Get prefix for a locale in routes
+ * Returns empty string for default locale if prefixDefaultLocale is false
+ */
+declare function getLocalePrefix(locale: string, config?: I18nConfig): string;
+/**
+ * Get content path prefix for a specific locale
+ * Returns the contentPathPrefix from locale config, or undefined if not set
+ */
+declare function getContentPathPrefix(locale: string, config?: I18nConfig): string | undefined;
+/**
+ * Filter posts by locale based on contentPathPrefix
+ * If contentPathPrefix is set, only return posts that start with that prefix
+ * If not set, return all posts (backward compatible)
+ *
+ * @example
+ * // If en locale has contentPathPrefix: 'blog_docs_en'
+ * filterPostsByLocale(posts, 'en', config)
+ * // Returns only posts with id starting with 'blog_docs_en/'
+ */
+declare function filterPostsByLocale<T extends {
+    id: string;
+}>(posts: T[], locale: string, config?: I18nConfig): T[];
+
+export { type AlternateLink, I18nConfig, Locale, type MergedLocaleConfig, UITranslations, filterPostsByLocale, formatDate, formatDateShort, getAlternateLinks, getContentPathPrefix, getLocaleByCode, getLocaleConfig, getLocaleFromPath, getLocalePrefix, getLocalizedPath, getTextDirection, isMultiLanguageEnabled, isRTL, removeLocalePrefix, t };