valaxy 0.28.0-beta.6 → 0.28.0

package/shared/utils/i18n.ts

@@ -1,3 +1,7 @@
+import { LOCALE_PREFIX } from '../constants'
+
+export type TaxonomyNamespace = 'tag' | 'category'
+
 /**
  * translate object
  *
@@ -15,3 +19,54 @@ export function tObject<T = string>(data: string | Record<string, T>, lang: stri
   }
   return data
 }
+
+/**
+ * Whether the value is an explicit locale key like `$locale:tag.notes`.
+ */
+export function isLocaleKey(value: string): boolean {
+  return value.startsWith(LOCALE_PREFIX)
+}
+
+/**
+ * Strip `$locale:` prefix when present.
+ */
+export function stripLocalePrefix(value: string): string {
+  return isLocaleKey(value) ? value.slice(LOCALE_PREFIX.length) : value
+}
+
+/**
+ * Resolve a nested locale message value by dot-separated key.
+ */
+export function getLocaleMessageValue(messages: Record<string, any> | undefined, key: string): any {
+  return key.split('.').reduce<any>((result, part) => result?.[part], messages)
+}
+
+/**
+ * Whether a locale message exists for the given key.
+ */
+export function hasLocaleMessage(messages: Record<string, any> | undefined, key: string): boolean {
+  return getLocaleMessageValue(messages, key) !== undefined
+}
+
+/**
+ * Resolve the effective locale key for a taxonomy term.
+ *
+ * - `$locale:tag.notes` -> `tag.notes` (explicit locale key)
+ * - `notes` in `tag` namespace -> `tag.notes`
+ */
+export function resolveTaxonomyLocaleKey(namespace: TaxonomyNamespace, rawValue: string): {
+  localeKey: string
+  isExplicitLocaleKey: boolean
+} {
+  if (isLocaleKey(rawValue)) {
+    return {
+      localeKey: stripLocalePrefix(rawValue),
+      isExplicitLocaleKey: true,
+    }
+  }
+
+  return {
+    localeKey: `${namespace}.${rawValue}`,
+    isExplicitLocaleKey: false,
+  }
+}

package/types/config.ts

@@ -172,10 +172,6 @@ export interface SiteConfig {
      * @zh 是否启用
      */
     enable: boolean
-    /**
-     * @deprecated will be deprecated, use search.provider instead
-     */
-    type?: SiteConfig['search']['provider']
     /**
      * Search Type
      * - algolia: Algolia Search

package/types/frontmatter/page.ts

@@ -109,6 +109,18 @@ export interface PageFrontMatter extends BaseFrontMatter {
    * @description 封面图片
    */
   cover: string
+  /**
+   * @description:en-US Open Graph image for SEO
+   * @description:zh-CN Open Graph 图片，用于 SEO
+   */
+  ogImage: string
+  /**
+   * @protected
+   * @tutorial ⚠️ DO NOT SET MANUALLY (auto-extracted from markdown content)
+   * @description:en-US First image URL extracted from markdown content
+   * @description:zh-CN 从 Markdown 内容中自动提取的第一张图片 URL
+   */
+  firstImage: string
   /**
    * display toc
    * @description 是否显示目录