@vigilkids/cms-nuxt 0.4.0 → 0.5.0

package/CHANGELOG.md

@@ -5,6 +5,18 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [0.5.0] - 2026-06-03
+
+### Added
+
+- Added `useLocalizedResourceSeo()` for locale-aware CMS resource metadata, canonical links, Open Graph tags, and Twitter Card tags.
+- Added category metadata exposure in `useCmsCategories()` for taxonomy landing pages.
+
+### Changed
+
+- `useBlogSeo()` now delegates to the shared localized resource SEO pipeline.
+- Updated peer dependency to `@vigilkids/cms-client ^0.3.0`.
+
 ## [0.4.0] - 2026-06-03
 
 ### Added

package/README.md

@@ -13,7 +13,7 @@ pnpm add @vigilkids/cms-nuxt @vigilkids/cms-client
 ## Peer Dependencies
 
 - `nuxt >=3.15.0`
-- `@vigilkids/cms-client ^0.2.0`
+- `@vigilkids/cms-client ^0.3.0`
 - `@nuxtjs/sitemap` is optional and only required when `cms.sitemap.enabled` is `true`
 
 ## Module Setup
@@ -265,7 +265,7 @@ All runtime composables are auto-imported.
 ## Compatibility
 
 - Nuxt `>=3.15.0`
-- `@vigilkids/cms-client ^0.2.0`
+- `@vigilkids/cms-client ^0.3.0`
 - Vue runtime supplied by Nuxt
 - Node.js version should satisfy the consuming Nuxt application's runtime requirements
 

package/dist/module.json

@@ -4,7 +4,7 @@
   "compatibility": {
     "nuxt": ">=3.15.0"
   },
-  "version": "0.4.0",
+  "version": "0.5.0",
   "builder": {
     "@nuxt/module-builder": "0.8.4",
     "unbuild": "unknown"

package/dist/runtime/composables/useBlogSeo.d.ts

@@ -1,9 +1,25 @@
+import type { LocalizedOgMetaMap, LocalizedSeoMetaMap, LocalizedTwitterMetaMap } from '@vigilkids/cms-client/types';
 import type { MaybeRefOrGetter } from 'vue';
+export interface UseLocalizedResourceSeoOptions {
+    locale: MaybeRefOrGetter<string>;
+    fallbackTitle: MaybeRefOrGetter<string>;
+    fallbackDescription?: MaybeRefOrGetter<string | null | undefined>;
+    fallbackImage?: MaybeRefOrGetter<string | null | undefined>;
+    fallbackLocale?: MaybeRefOrGetter<string | null | undefined>;
+    seoMeta?: MaybeRefOrGetter<LocalizedSeoMetaMap | undefined>;
+    ogMeta?: MaybeRefOrGetter<LocalizedOgMetaMap | undefined>;
+    twitterMeta?: MaybeRefOrGetter<LocalizedTwitterMetaMap | undefined>;
+    defaultOgType?: MaybeRefOrGetter<string | null | undefined>;
+    robots?: MaybeRefOrGetter<string | null | undefined>;
+}
+/** 本地化资源 SEO 元信息 */
+export declare function useLocalizedResourceSeo(options: UseLocalizedResourceSeoOptions): void;
 /** 博客列表页 SEO */
 export declare function useBlogSeo(options: {
     title: MaybeRefOrGetter<string>;
     description?: MaybeRefOrGetter<string>;
     image?: MaybeRefOrGetter<string | undefined>;
+    locale?: MaybeRefOrGetter<string>;
     noindex?: boolean;
 }): void;
 //# sourceMappingURL=useBlogSeo.d.ts.map

package/dist/runtime/composables/useBlogSeo.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useBlogSeo.d.ts","sourceRoot":"","sources":["../../../src/runtime/composables/useBlogSeo.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,KAAK,CAAA;AAI3C,gBAAgB;AAChB,wBAAgB,UAAU,CAAC,OAAO,EAAE;IAClC,KAAK,EAAE,gBAAgB,CAAC,MAAM,CAAC,CAAA;IAC/B,WAAW,CAAC,EAAE,gBAAgB,CAAC,MAAM,CAAC,CAAA;IACtC,KAAK,CAAC,EAAE,gBAAgB,CAAC,MAAM,GAAG,SAAS,CAAC,CAAA;IAC5C,OAAO,CAAC,EAAE,OAAO,CAAA;CAClB,QAcA"}
+{"version":3,"file":"useBlogSeo.d.ts","sourceRoot":"","sources":["../../../src/runtime/composables/useBlogSeo.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,kBAAkB,EAClB,mBAAmB,EACnB,uBAAuB,EACxB,MAAM,6BAA6B,CAAA;AACpC,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,KAAK,CAAA;AAI3C,MAAM,WAAW,8BAA8B;IAC7C,MAAM,EAAE,gBAAgB,CAAC,MAAM,CAAC,CAAA;IAChC,aAAa,EAAE,gBAAgB,CAAC,MAAM,CAAC,CAAA;IACvC,mBAAmB,CAAC,EAAE,gBAAgB,CAAC,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC,CAAA;IACjE,aAAa,CAAC,EAAE,gBAAgB,CAAC,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC,CAAA;IAC3D,cAAc,CAAC,EAAE,gBAAgB,CAAC,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC,CAAA;IAC5D,OAAO,CAAC,EAAE,gBAAgB,CAAC,mBAAmB,GAAG,SAAS,CAAC,CAAA;IAC3D,MAAM,CAAC,EAAE,gBAAgB,CAAC,kBAAkB,GAAG,SAAS,CAAC,CAAA;IACzD,WAAW,CAAC,EAAE,gBAAgB,CAAC,uBAAuB,GAAG,SAAS,CAAC,CAAA;IACnE,aAAa,CAAC,EAAE,gBAAgB,CAAC,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC,CAAA;IAC3D,MAAM,CAAC,EAAE,gBAAgB,CAAC,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC,CAAA;CACrD;AAoED,oBAAoB;AACpB,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,8BAA8B,QAwD9E;AAED,gBAAgB;AAChB,wBAAgB,UAAU,CAAC,OAAO,EAAE;IAClC,KAAK,EAAE,gBAAgB,CAAC,MAAM,CAAC,CAAA;IAC/B,WAAW,CAAC,EAAE,gBAAgB,CAAC,MAAM,CAAC,CAAA;IACtC,KAAK,CAAC,EAAE,gBAAgB,CAAC,MAAM,GAAG,SAAS,CAAC,CAAA;IAC5C,MAAM,CAAC,EAAE,gBAAgB,CAAC,MAAM,CAAC,CAAA;IACjC,OAAO,CAAC,EAAE,OAAO,CAAA;CAClB,QASA"}

package/dist/runtime/composables/useBlogSeo.js

@@ -1,16 +1,102 @@
-import { useSeoMeta } from "#imports";
-import { toRef } from "vue";
-export function useBlogSeo(options) {
-  const title = toRef(options.title);
-  const description = toRef(options.description ?? "");
-  const image = toRef(options.image);
+import { useHead, useSeoMeta } from "#imports";
+import { computed, toValue } from "vue";
+const OPEN_GRAPH_TYPES = /* @__PURE__ */ new Set([
+  "article",
+  "book",
+  "music.album",
+  "music.playlist",
+  "music.radio_status",
+  "music.song",
+  "profile",
+  "video.episode",
+  "video.movie",
+  "video.other",
+  "video.tv_show",
+  "website"
+]);
+const TWITTER_CARDS = /* @__PURE__ */ new Set(["app", "player", "summary", "summary_large_image"]);
+function present(value) {
+  const normalized = value?.trim();
+  return normalized || void 0;
+}
+function normalizeOpenGraphType(value) {
+  const normalized = present(value);
+  if (!normalized) {
+    return void 0;
+  }
+  return OPEN_GRAPH_TYPES.has(normalized) ? normalized : void 0;
+}
+function normalizeTwitterCard(value) {
+  const normalized = present(value);
+  if (!normalized) {
+    return void 0;
+  }
+  return TWITTER_CARDS.has(normalized) ? normalized : void 0;
+}
+function localizedEntry(value, locale, fallbackLocale) {
+  let fallbackEntry;
+  if (fallbackLocale) {
+    fallbackEntry = value?.[fallbackLocale];
+  }
+  return value?.[locale] ?? fallbackEntry ?? Object.values(value ?? {})[0];
+}
+export function useLocalizedResourceSeo(options) {
+  const locale = computed(() => toValue(options.locale));
+  const fallbackLocale = computed(() => toValue(options.fallbackLocale));
+  const seoMeta = computed(
+    () => localizedEntry(toValue(options.seoMeta), locale.value, fallbackLocale.value)
+  );
+  const ogMeta = computed(
+    () => localizedEntry(toValue(options.ogMeta), locale.value, fallbackLocale.value)
+  );
+  const twitterMeta = computed(
+    () => localizedEntry(toValue(options.twitterMeta), locale.value, fallbackLocale.value)
+  );
+  const fallbackTitle = computed(() => toValue(options.fallbackTitle));
+  const fallbackDescription = computed(() => toValue(options.fallbackDescription) ?? "");
+  const fallbackImage = computed(() => present(toValue(options.fallbackImage)));
+  const resolvedTitle = computed(() => present(seoMeta.value?.title) ?? fallbackTitle.value);
+  const resolvedDescription = computed(
+    () => present(seoMeta.value?.description) ?? fallbackDescription.value
+  );
+  const resolvedImage = computed(
+    () => present(ogMeta.value?.image) ?? present(twitterMeta.value?.image) ?? fallbackImage.value
+  );
+  const resolvedOgType = computed(
+    () => normalizeOpenGraphType(ogMeta.value?.type) ?? normalizeOpenGraphType(toValue(options.defaultOgType)) ?? "website"
+  );
+  const resolvedTwitterCard = computed(
+    () => normalizeTwitterCard(twitterMeta.value?.card) ?? (resolvedImage.value ? "summary_large_image" : void 0)
+  );
   useSeoMeta({
-    title: () => title.value,
-    description: () => description.value,
-    ogTitle: () => title.value,
-    ogDescription: () => description.value,
-    ogImage: () => image.value,
-    ogType: "website",
-    ...options.noindex ? { robots: "noindex, follow" } : {}
+    title: () => resolvedTitle.value,
+    description: () => resolvedDescription.value,
+    keywords: () => present(seoMeta.value?.keywords),
+    robots: () => present(toValue(options.robots)) ?? present(seoMeta.value?.robots),
+    ogTitle: () => present(ogMeta.value?.title) ?? resolvedTitle.value,
+    ogDescription: () => present(ogMeta.value?.description) ?? resolvedDescription.value,
+    ogImage: () => resolvedImage.value,
+    ogUrl: () => present(ogMeta.value?.url),
+    ogType: () => resolvedOgType.value,
+    twitterCard: () => resolvedTwitterCard.value,
+    twitterTitle: () => present(twitterMeta.value?.title) ?? resolvedTitle.value,
+    twitterDescription: () => present(twitterMeta.value?.description) ?? resolvedDescription.value,
+    twitterImage: () => resolvedImage.value
+  });
+  useHead({
+    link: () => {
+      const canonicalUrl = present(seoMeta.value?.canonical_url);
+      return canonicalUrl ? [{ rel: "canonical", href: canonicalUrl }] : [];
+    }
+  });
+}
+export function useBlogSeo(options) {
+  useLocalizedResourceSeo({
+    locale: options.locale ?? "",
+    fallbackTitle: options.title,
+    fallbackDescription: options.description ?? "",
+    fallbackImage: options.image,
+    defaultOgType: "website",
+    robots: options.noindex ? "noindex, follow" : void 0
   });
 }

package/dist/runtime/composables/useCmsCategories.d.ts

@@ -1,9 +1,15 @@
-import type { CategoryNode } from '@vigilkids/cms-client/types';
+import type { CategoryNode, LocalizedOgMetaMap, LocalizedSeoMetaMap, LocalizedTwitterMetaMap, OgMeta, SeoMeta, TwitterMeta } from '@vigilkids/cms-client/types';
 export interface CmsResolvedCategory {
     id: number;
     slug: string;
     name: string;
     description?: string;
+    seoMeta?: Partial<SeoMeta>;
+    ogMeta?: Partial<OgMeta>;
+    twitterMeta?: Partial<TwitterMeta>;
+    localizedSeoMeta?: LocalizedSeoMetaMap;
+    localizedOgMeta?: LocalizedOgMetaMap;
+    localizedTwitterMeta?: LocalizedTwitterMetaMap;
     articleCount: number;
 }
 /** CMS 分类预加载数据和路由工具 */
@@ -17,6 +23,32 @@ export declare function useCmsCategories(): {
         readonly description: {
             readonly [x: string]: string;
         };
+        readonly seo_meta?: {
+            readonly [x: string]: {
+                readonly title?: string | null | undefined;
+                readonly description?: string | null | undefined;
+                readonly keywords?: string | null | undefined;
+                readonly robots?: string | null | undefined;
+                readonly canonical_url?: string | null | undefined;
+            };
+        } | undefined;
+        readonly og_meta?: {
+            readonly [x: string]: {
+                readonly title?: string | null | undefined;
+                readonly description?: string | null | undefined;
+                readonly image?: string | null | undefined;
+                readonly url?: string | null | undefined;
+                readonly type?: string | null | undefined;
+            };
+        } | undefined;
+        readonly twitter_meta?: {
+            readonly [x: string]: {
+                readonly card?: string | null | undefined;
+                readonly title?: string | null | undefined;
+                readonly description?: string | null | undefined;
+                readonly image?: string | null | undefined;
+            };
+        } | undefined;
         readonly article_count: number;
         readonly article_counts?: {
             readonly [x: string]: number;
@@ -31,6 +63,32 @@ export declare function useCmsCategories(): {
         readonly description: {
             readonly [x: string]: string;
         };
+        readonly seo_meta?: {
+            readonly [x: string]: {
+                readonly title?: string | null | undefined;
+                readonly description?: string | null | undefined;
+                readonly keywords?: string | null | undefined;
+                readonly robots?: string | null | undefined;
+                readonly canonical_url?: string | null | undefined;
+            };
+        } | undefined;
+        readonly og_meta?: {
+            readonly [x: string]: {
+                readonly title?: string | null | undefined;
+                readonly description?: string | null | undefined;
+                readonly image?: string | null | undefined;
+                readonly url?: string | null | undefined;
+                readonly type?: string | null | undefined;
+            };
+        } | undefined;
+        readonly twitter_meta?: {
+            readonly [x: string]: {
+                readonly card?: string | null | undefined;
+                readonly title?: string | null | undefined;
+                readonly description?: string | null | undefined;
+                readonly image?: string | null | undefined;
+            };
+        } | undefined;
         readonly article_count: number;
         readonly article_counts?: {
             readonly [x: string]: number;
@@ -46,6 +104,32 @@ export declare function useCmsCategories(): {
         readonly description: {
             readonly [x: string]: string;
         };
+        readonly seo_meta?: {
+            readonly [x: string]: {
+                readonly title?: string | null | undefined;
+                readonly description?: string | null | undefined;
+                readonly keywords?: string | null | undefined;
+                readonly robots?: string | null | undefined;
+                readonly canonical_url?: string | null | undefined;
+            };
+        } | undefined;
+        readonly og_meta?: {
+            readonly [x: string]: {
+                readonly title?: string | null | undefined;
+                readonly description?: string | null | undefined;
+                readonly image?: string | null | undefined;
+                readonly url?: string | null | undefined;
+                readonly type?: string | null | undefined;
+            };
+        } | undefined;
+        readonly twitter_meta?: {
+            readonly [x: string]: {
+                readonly card?: string | null | undefined;
+                readonly title?: string | null | undefined;
+                readonly description?: string | null | undefined;
+                readonly image?: string | null | undefined;
+            };
+        } | undefined;
         readonly article_count: number;
         readonly article_counts?: {
             readonly [x: string]: number;
@@ -60,6 +144,32 @@ export declare function useCmsCategories(): {
         readonly description: {
             readonly [x: string]: string;
         };
+        readonly seo_meta?: {
+            readonly [x: string]: {
+                readonly title?: string | null | undefined;
+                readonly description?: string | null | undefined;
+                readonly keywords?: string | null | undefined;
+                readonly robots?: string | null | undefined;
+                readonly canonical_url?: string | null | undefined;
+            };
+        } | undefined;
+        readonly og_meta?: {
+            readonly [x: string]: {
+                readonly title?: string | null | undefined;
+                readonly description?: string | null | undefined;
+                readonly image?: string | null | undefined;
+                readonly url?: string | null | undefined;
+                readonly type?: string | null | undefined;
+            };
+        } | undefined;
+        readonly twitter_meta?: {
+            readonly [x: string]: {
+                readonly card?: string | null | undefined;
+                readonly title?: string | null | undefined;
+                readonly description?: string | null | undefined;
+                readonly image?: string | null | undefined;
+            };
+        } | undefined;
         readonly article_count: number;
         readonly article_counts?: {
             readonly [x: string]: number;

package/dist/runtime/composables/useCmsCategories.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useCmsCategories.d.ts","sourceRoot":"","sources":["../../../src/runtime/composables/useCmsCategories.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAA;AAK/D,MAAM,WAAW,mBAAmB;IAClC,EAAE,EAAE,MAAM,CAAA;IACV,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,MAAM,CAAA;IACZ,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,YAAY,EAAE,MAAM,CAAA;CACrB;AAqBD,uBAAuB;AACvB,wBAAgB,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;gCAcK,YAAY,sBAAkB,mBAAmB;gCAkBjD,IAAI,CAAC,YAAY,EAAE,MAAM,CAAC;;2BAJ/B,MAAM;uBAJV,MAAM;EA4BjC"}
+{"version":3,"file":"useCmsCategories.d.ts","sourceRoot":"","sources":["../../../src/runtime/composables/useCmsCategories.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,YAAY,EACZ,kBAAkB,EAClB,mBAAmB,EACnB,uBAAuB,EACvB,MAAM,EACN,OAAO,EACP,WAAW,EACZ,MAAM,6BAA6B,CAAA;AAKpC,MAAM,WAAW,mBAAmB;IAClC,EAAE,EAAE,MAAM,CAAA;IACV,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,MAAM,CAAA;IACZ,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,OAAO,CAAC,EAAE,OAAO,CAAC,OAAO,CAAC,CAAA;IAC1B,MAAM,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,CAAA;IACxB,WAAW,CAAC,EAAE,OAAO,CAAC,WAAW,CAAC,CAAA;IAClC,gBAAgB,CAAC,EAAE,mBAAmB,CAAA;IACtC,eAAe,CAAC,EAAE,kBAAkB,CAAA;IACpC,oBAAoB,CAAC,EAAE,uBAAuB,CAAA;IAC9C,YAAY,EAAE,MAAM,CAAA;CACrB;AA+BD,uBAAuB;AACvB,wBAAgB,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;gCAcK,YAAY,sBAAkB,mBAAmB;gCAwBjD,IAAI,CAAC,YAAY,EAAE,MAAM,CAAC;;2BAJ/B,MAAM;uBAJV,MAAM;EA4BjC"}

package/dist/runtime/composables/useCmsCategories.js

@@ -2,17 +2,22 @@ import { useRuntimeConfig } from "#imports";
 import { computed, readonly } from "vue";
 import { useCmsRoutes } from "./useCmsRoutes.js";
 function localizedText(value, locale, fallback) {
-  if (!value)
+  if (!value) {
     return fallback;
+  }
   return value[locale] || value.en || Object.values(value)[0] || fallback;
 }
+function localizedEntry(value, locale) {
+  return value?.[locale] ?? value?.en ?? Object.values(value ?? {})[0];
+}
 function flattenCategories(categories) {
   const result = [];
   function walk(nodes) {
     for (const node of nodes) {
       result.push(node);
-      if (node.children?.length)
+      if (node.children?.length) {
         walk(node.children);
+      }
     }
   }
   walk(categories);
@@ -30,6 +35,12 @@ export function useCmsCategories() {
       slug: category.slug,
       name: localizedText(category.name, locale, category.slug),
       description: localizedText(category.description, locale, ""),
+      seoMeta: localizedEntry(category.seo_meta, locale),
+      ogMeta: localizedEntry(category.og_meta, locale),
+      twitterMeta: localizedEntry(category.twitter_meta, locale),
+      localizedSeoMeta: category.seo_meta,
+      localizedOgMeta: category.og_meta,
+      localizedTwitterMeta: category.twitter_meta,
       articleCount: category.article_count
     };
   }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vigilkids/cms-nuxt",
-  "version": "0.4.0",
+  "version": "0.5.0",
   "description": "Nuxt 3 module for OnEx CMS — composables, server routes, middleware, sitemap",
   "type": "module",
   "main": "./dist/module.mjs",
@@ -44,7 +44,7 @@
     "vue": "^3.4.0"
   },
   "peerDependencies": {
-    "@vigilkids/cms-client": "^0.2.0",
+    "@vigilkids/cms-client": "^0.3.0",
     "nuxt": ">=3.15.0"
   },
   "peerDependenciesMeta": {