@vigilkids/cms-nuxt 0.2.3 → 0.4.0

package/dist/runtime/composables/useArticle.js

@@ -1,4 +1,4 @@
-import { useAsyncData, useHead, useRuntimeConfig, useSeoMeta } from "#imports";
+import { useAsyncData, useHead, useSeoMeta } from "#imports";
 import { computed, toRef } from "vue";
 import { toArray } from "../utils/list.js";
 import { useCmsClient } from "./useCmsClient.js";
@@ -38,30 +38,6 @@ export function useArticle(slug) {
       return [{ type: "application/ld+json", innerHTML: JSON.stringify(article.value.json_ld) }];
     }
   });
-  useHead({
-    link: () => {
-      const a = article.value;
-      if (!a?.available_locales || a.available_locales.length <= 1)
-        return [];
-      const publicConfig = useRuntimeConfig().public;
-      const siteUrl = publicConfig.siteUrl ?? "";
-      const defaultSlug = a.localized_slugs?.en ?? a.slug;
-      const links = a.available_locales.map((locale) => {
-        const slug2 = a.localized_slugs?.[locale] ?? a.slug;
-        return {
-          rel: "alternate",
-          hreflang: locale,
-          href: locale === "en" ? `${siteUrl}/blog/${slug2}` : `${siteUrl}/${locale}/blog/${slug2}`
-        };
-      });
-      links.push({
-        rel: "alternate",
-        hreflang: "x-default",
-        href: `${siteUrl}/blog/${defaultSlug}`
-      });
-      return links;
-    }
-  });
   return {
     article,
     relatedArticles: relatedArticleList,

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

@@ -0,0 +1,11 @@
+import type { ArticleListItem, ArticleListParams, PaginationMeta } from '@vigilkids/cms-client/types';
+import type { MaybeRefOrGetter } from 'vue';
+/** 文章列表 + 分页 */
+export declare function useArticleList(params: MaybeRefOrGetter<ArticleListParams>): {
+    articles: import("vue").ComputedRef<ArticleListItem[]>;
+    pagination: import("vue").ComputedRef<PaginationMeta | null>;
+    status: import("#imports").Ref<string, string>;
+    error: import("#imports").Ref<Error | null, Error | null>;
+    refresh: () => Promise<void>;
+};
+//# sourceMappingURL=useArticleList.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useArticleList.d.ts","sourceRoot":"","sources":["../../../src/runtime/composables/useArticleList.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,eAAe,EACf,iBAAiB,EACjB,cAAc,EACf,MAAM,6BAA6B,CAAA;AACpC,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,KAAK,CAAA;AAK3C,gBAAgB;AAChB,wBAAgB,cAAc,CAAC,MAAM,EAAE,gBAAgB,CAAC,iBAAiB,CAAC;;;;;;EAczE"}

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

@@ -0,0 +1,10 @@
+import type { ArticleListItem, Author } from '@vigilkids/cms-client/types';
+import type { ComputedRef, MaybeRefOrGetter, Ref } from 'vue';
+/** 作者详情 + 文章列表 */
+export declare function useAuthor(slug: MaybeRefOrGetter<string>): {
+    author: Ref<Author | null>;
+    articles: ComputedRef<ArticleListItem[]>;
+    status: Ref<string, string>;
+    error: Ref<Error | null, Error | null>;
+};
+//# sourceMappingURL=useAuthor.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useAuthor.d.ts","sourceRoot":"","sources":["../../../src/runtime/composables/useAuthor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,EAAE,MAAM,6BAA6B,CAAA;AAC1E,OAAO,KAAK,EAAE,WAAW,EAAE,gBAAgB,EAAE,GAAG,EAAE,MAAM,KAAK,CAAA;AAM7D,kBAAkB;AAClB,wBAAgB,SAAS,CAAC,IAAI,EAAE,gBAAgB,CAAC,MAAM,CAAC;YAoBlC,GAAG,CAAC,MAAM,GAAG,IAAI,CAAC;cACX,WAAW,CAAC,eAAe,EAAE,CAAC;;;EAI1D"}

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

@@ -0,0 +1,9 @@
+import type { MaybeRefOrGetter } from 'vue';
+/** 博客列表页 SEO */
+export declare function useBlogSeo(options: {
+    title: MaybeRefOrGetter<string>;
+    description?: MaybeRefOrGetter<string>;
+    image?: MaybeRefOrGetter<string | undefined>;
+    noindex?: boolean;
+}): void;
+//# sourceMappingURL=useBlogSeo.d.ts.map

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

@@ -0,0 +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"}

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

@@ -0,0 +1,10 @@
+import type { CategoryNode } from '@vigilkids/cms-client/types';
+/** 分类树 + 工具方法 */
+export declare function useCategories(): {
+    categories: import("vue").ComputedRef<CategoryNode[]>;
+    flatCategories: import("vue").ComputedRef<CategoryNode[]>;
+    findBySlug: (slug: string) => CategoryNode | undefined;
+    status: import("#imports").Ref<string, string>;
+    error: import("#imports").Ref<Error | null, Error | null>;
+};
+//# sourceMappingURL=useCategories.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useCategories.d.ts","sourceRoot":"","sources":["../../../src/runtime/composables/useCategories.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAA;AAM/D,iBAAiB;AACjB,wBAAgB,aAAa;;;uBAsBD,MAAM,KAAG,YAAY,GAAG,SAAS;;;EAK5D"}

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

@@ -0,0 +1,14 @@
+import type { ArticleListItem, ArticleListParams, PaginationMeta } from '@vigilkids/cms-client/types';
+import type { MaybeRefOrGetter } from 'vue';
+export interface CmsArticleCollectionParams extends ArticleListParams {
+    q?: string;
+}
+/** CMS 文章集合查询，统一支持分类、搜索和分页 */
+export declare function useCmsArticleCollection(params: MaybeRefOrGetter<CmsArticleCollectionParams>): {
+    articles: import("vue").ComputedRef<ArticleListItem[]>;
+    pagination: import("vue").ComputedRef<PaginationMeta | null>;
+    status: import("#imports").Ref<string, string>;
+    error: import("#imports").Ref<Error | null, Error | null>;
+    refresh: () => Promise<void>;
+};
+//# sourceMappingURL=useCmsArticleCollection.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useCmsArticleCollection.d.ts","sourceRoot":"","sources":["../../../src/runtime/composables/useCmsArticleCollection.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,iBAAiB,EAAa,cAAc,EAAE,MAAM,6BAA6B,CAAA;AAChH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,KAAK,CAAA;AAI3C,MAAM,WAAW,0BAA2B,SAAQ,iBAAiB;IACnE,CAAC,CAAC,EAAE,MAAM,CAAA;CACX;AAED,8BAA8B;AAC9B,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,gBAAgB,CAAC,0BAA0B,CAAC;;;;;;EAkB3F"}

package/dist/runtime/composables/useCmsArticleCollection.js

@@ -0,0 +1,16 @@
+import { useAsyncData, useRuntimeConfig } from "#imports";
+import { computed, toRef } from "vue";
+export function useCmsArticleCollection(params) {
+  const resolvedParams = toRef(params);
+  const config = useRuntimeConfig();
+  const cmsConfig = config.public.cms;
+  const endpoint = cmsConfig.content?.articleCollectionPath ?? "/api/cms/articles";
+  const { data, status, error, refresh } = useAsyncData(
+    `cms-article-collection-${JSON.stringify(resolvedParams.value)}`,
+    () => $fetch(endpoint, { params: resolvedParams.value }),
+    { watch: [resolvedParams] }
+  );
+  const articles = computed(() => data.value?.data ?? []);
+  const pagination = computed(() => data.value?.pagination ?? null);
+  return { articles, pagination, status, error, refresh };
+}

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

@@ -0,0 +1,78 @@
+import type { CategoryNode } from '@vigilkids/cms-client/types';
+export interface CmsResolvedCategory {
+    id: number;
+    slug: string;
+    name: string;
+    description?: string;
+    articleCount: number;
+}
+/** CMS 分类预加载数据和路由工具 */
+export declare function useCmsCategories(): {
+    rawCategories: Readonly<import("#imports").Ref<readonly {
+        readonly id: number;
+        readonly slug: string;
+        readonly name: {
+            readonly [x: string]: string;
+        };
+        readonly description: {
+            readonly [x: string]: string;
+        };
+        readonly article_count: number;
+        readonly article_counts?: {
+            readonly [x: string]: number;
+        } | undefined;
+        readonly children?: readonly /*elided*/ any[] | undefined;
+    }[], readonly {
+        readonly id: number;
+        readonly slug: string;
+        readonly name: {
+            readonly [x: string]: string;
+        };
+        readonly description: {
+            readonly [x: string]: string;
+        };
+        readonly article_count: number;
+        readonly article_counts?: {
+            readonly [x: string]: number;
+        } | undefined;
+        readonly children?: readonly /*elided*/ any[] | undefined;
+    }[]>>;
+    flatCategories: Readonly<import("#imports").Ref<readonly {
+        readonly id: number;
+        readonly slug: string;
+        readonly name: {
+            readonly [x: string]: string;
+        };
+        readonly description: {
+            readonly [x: string]: string;
+        };
+        readonly article_count: number;
+        readonly article_counts?: {
+            readonly [x: string]: number;
+        } | undefined;
+        readonly children?: readonly /*elided*/ any[] | undefined;
+    }[], readonly {
+        readonly id: number;
+        readonly slug: string;
+        readonly name: {
+            readonly [x: string]: string;
+        };
+        readonly description: {
+            readonly [x: string]: string;
+        };
+        readonly article_count: number;
+        readonly article_counts?: {
+            readonly [x: string]: number;
+        } | undefined;
+        readonly children?: readonly /*elided*/ any[] | undefined;
+    }[]>>;
+    currentCategories: import("vue").ComputedRef<CmsResolvedCategory[]>;
+    lastUpdated: string | undefined;
+    buildTime: string | undefined;
+    resolveCategory: (category: CategoryNode, locale?: string) => CmsResolvedCategory;
+    getCategoryPath: (category: Pick<CategoryNode, "slug">) => string;
+    getDisplayCategories: (locale?: string) => CmsResolvedCategory[];
+    categoryExists: (slug: string) => boolean;
+    findBySlug: (slug: string) => CategoryNode | undefined;
+};
+//# sourceMappingURL=useCmsCategories.d.ts.map

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

@@ -0,0 +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"}

package/dist/runtime/composables/useCmsCategories.js

@@ -0,0 +1,60 @@
+import { useRuntimeConfig } from "#imports";
+import { computed, readonly } from "vue";
+import { useCmsRoutes } from "./useCmsRoutes.js";
+function localizedText(value, locale, fallback) {
+  if (!value)
+    return fallback;
+  return value[locale] || value.en || Object.values(value)[0] || fallback;
+}
+function flattenCategories(categories) {
+  const result = [];
+  function walk(nodes) {
+    for (const node of nodes) {
+      result.push(node);
+      if (node.children?.length)
+        walk(node.children);
+    }
+  }
+  walk(categories);
+  return result;
+}
+export function useCmsCategories() {
+  const config = useRuntimeConfig();
+  const routes = useCmsRoutes();
+  const cmsConfig = config.public.cms;
+  const rawCategories = computed(() => cmsConfig.categories?.items ?? []);
+  const flatCategories = computed(() => flattenCategories(rawCategories.value));
+  function resolveCategory(category, locale = "en") {
+    return {
+      id: category.id,
+      slug: category.slug,
+      name: localizedText(category.name, locale, category.slug),
+      description: localizedText(category.description, locale, ""),
+      articleCount: category.article_count
+    };
+  }
+  function findBySlug(slug) {
+    return flatCategories.value.find((category) => category.slug === slug);
+  }
+  function categoryExists(slug) {
+    return Boolean(findBySlug(slug));
+  }
+  function getCategoryPath(category) {
+    return routes.build("category", { category_slug: category.slug });
+  }
+  function getDisplayCategories(locale = "en") {
+    return rawCategories.value.map((category) => resolveCategory(category, locale));
+  }
+  return {
+    rawCategories: readonly(rawCategories),
+    flatCategories: readonly(flatCategories),
+    currentCategories: computed(() => getDisplayCategories()),
+    lastUpdated: cmsConfig.categories?.lastUpdated,
+    buildTime: cmsConfig.categories?.buildTime,
+    resolveCategory,
+    getCategoryPath,
+    getDisplayCategories,
+    categoryExists,
+    findBySlug
+  };
+}

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

@@ -0,0 +1,4 @@
+import { CmsClient } from '@vigilkids/cms-client';
+/** 获取 CMS 客户端实例（SSR/CSR 通用） */
+export declare function useCmsClient(): CmsClient;
+//# sourceMappingURL=useCmsClient.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useCmsClient.d.ts","sourceRoot":"","sources":["../../../src/runtime/composables/useCmsClient.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAA;AAEjD,+BAA+B;AAC/B,wBAAgB,YAAY,IAAI,SAAS,CAexC"}

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

@@ -0,0 +1,19 @@
+import type { MaybeRefOrGetter, Ref } from 'vue';
+export interface CmsFetchError {
+    statusCode?: number;
+    statusMessage?: string;
+    message?: string;
+    [key: string]: unknown;
+}
+export interface CmsFetchResult<T> {
+    data: Ref<T | null>;
+    error: Ref<CmsFetchError | null>;
+    status: Ref<string>;
+    refresh: () => Promise<void>;
+    execute: () => Promise<void>;
+}
+/** CMS API 请求封装，SSR 直连 CMS，CSR 走 Nuxt 代理。 */
+export declare function useCmsFetch<T>(path: MaybeRefOrGetter<string>, options?: Record<string, unknown> & {
+    headers?: Record<string, string>;
+}): CmsFetchResult<T>;
+//# sourceMappingURL=useCmsFetch.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useCmsFetch.d.ts","sourceRoot":"","sources":["../../../src/runtime/composables/useCmsFetch.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,GAAG,EAAE,MAAM,KAAK,CAAA;AAIhD,MAAM,WAAW,aAAa;IAC5B,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;CACvB;AAED,MAAM,WAAW,cAAc,CAAC,CAAC;IAC/B,IAAI,EAAE,GAAG,CAAC,CAAC,GAAG,IAAI,CAAC,CAAA;IACnB,KAAK,EAAE,GAAG,CAAC,aAAa,GAAG,IAAI,CAAC,CAAA;IAChC,MAAM,EAAE,GAAG,CAAC,MAAM,CAAC,CAAA;IACnB,OAAO,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;IAC5B,OAAO,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;CAC7B;AAED,6CAA6C;AAC7C,wBAAgB,WAAW,CAAC,CAAC,EAC3B,IAAI,EAAE,gBAAgB,CAAC,MAAM,CAAC,EAC9B,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG;IAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAAE,GACvE,cAAc,CAAC,CAAC,CAAC,CAyBnB"}

package/dist/runtime/composables/useCmsFetch.js

@@ -0,0 +1,20 @@
+import { useFetch, useRuntimeConfig } from "#imports";
+import { useCmsPreviewToken } from "./useCmsPreview.js";
+export function useCmsFetch(path, options) {
+  const config = useRuntimeConfig();
+  const cmsConfig = config.public.cms;
+  const baseURL = import.meta.server ? cmsConfig.apiUrl : cmsConfig.content?.cmsProxyPath ?? "/cms-proxy";
+  const headers = { Accept: "application/json" };
+  if (cmsConfig.productCode) {
+    headers["X-Product-Code"] = cmsConfig.productCode;
+  }
+  const previewToken = useCmsPreviewToken();
+  if (previewToken.value) {
+    headers["X-Preview-Token"] = previewToken.value;
+  }
+  return useFetch(path, {
+    ...options,
+    baseURL,
+    headers: { ...headers, ...options?.headers }
+  });
+}

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

@@ -0,0 +1,16 @@
+import type { Ref } from 'vue';
+/**
+ * 获取预览 token（SWR 安全）。
+ *
+ * SSR 时从 event.context.__cms_preview_token 读取，该值由 preview-context
+ * 中间件写入，通过引用共享穿越 Nitro SWR 合成事件边界。
+ * CSR 时从 cookie 读取（客户端不受 SWR 影响）。
+ */
+export declare function useCmsPreviewToken(): Ref<string | null>;
+/** 预览模式管理 */
+export declare function useCmsPreview(): {
+    isPreview: import("vue").ComputedRef<boolean>;
+    previewToken: Ref<string | null, string | null>;
+    exitPreview: () => void;
+};
+//# sourceMappingURL=useCmsPreview.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useCmsPreview.d.ts","sourceRoot":"","sources":["../../../src/runtime/composables/useCmsPreview.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,KAAK,CAAA;AAI9B;;;;;;GAMG;AACH,wBAAgB,kBAAkB,IAAI,GAAG,CAAC,MAAM,GAAG,IAAI,CAAC,CAgBvD;AAED,aAAa;AACb,wBAAgB,aAAa;;;;EAkB5B"}

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

@@ -0,0 +1,7 @@
+import type { CmsRouteParams } from '../../types';
+/** CMS 资源路由生成器 */
+export declare function useCmsRoutes(): {
+    policy: Required<import("../../types").CmsRoutePolicy>;
+    build: (resource: string, params?: CmsRouteParams, includeLocale?: boolean) => string;
+};
+//# sourceMappingURL=useCmsRoutes.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useCmsRoutes.d.ts","sourceRoot":"","sources":["../../../src/runtime/composables/useCmsRoutes.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAA;AAIjD,kBAAkB;AAClB,wBAAgB,YAAY;;sBAID,MAAM,WAAU,cAAc;EAKxD"}

package/dist/runtime/composables/useCmsRoutes.js

@@ -0,0 +1,10 @@
+import { useRuntimeConfig } from "#imports";
+import { buildCmsPath, resolveCmsRoutePolicy } from "../utils/routes.js";
+export function useCmsRoutes() {
+  const config = useRuntimeConfig();
+  const policy = resolveCmsRoutePolicy(config.public.cms);
+  function build(resource, params = {}, includeLocale = false) {
+    return buildCmsPath(policy, resource, params, { includeLocale });
+  }
+  return { policy, build };
+}

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

@@ -0,0 +1,34 @@
+import type { MaybeRefOrGetter } from 'vue';
+/** 任何具备多语言能力的 CMS 资源应满足的最小契约。 */
+export interface HreflangResource {
+    slug: string;
+    available_locales?: string[];
+    localized_slugs?: Record<string, string>;
+}
+export interface HreflangBuilderParams<T extends HreflangResource> {
+    /** 当前 locale code；包内对 x-default 单独再调用一次，传入字面量 'x-default'。 */
+    locale: string | 'x-default';
+    /** 对应 locale 的本地化 slug；无本地化时回退到资源原 slug。 */
+    slug: string;
+    /** 完整资源对象，builder 可读取 category / author 等领域字段拼路径。 */
+    resource: T;
+}
+/**
+ * 按资源的 available_locales 注入 hreflang `<link>` 标签。
+ *
+ * 包内只负责"按 available_locales 过滤 + 添加 x-default 入口"；URL 路径结构、
+ * locale 前缀策略、trailing slash、siteUrl 拼接全部交由 builder 决定，
+ * 因此可适配任意资源路由模式（/{category}/{slug}、/authors/{slug} 等）。
+ *
+ * 每条 link 带上 `key: cms-hreflang-{locale}`，便于 unhead 跨多次调用去重。
+ *
+ * @example
+ *   useHreflangLinks(article, ({ locale, slug, resource }) => {
+ *     const origin = `https://${siteUrl}`
+ *     if (locale === 'x-default') return `${origin}/${resource.category}/${slug}/`
+ *     const prefix = locale === 'en' ? '' : `/${locale}`
+ *     return `${origin}${prefix}/${resource.category}/${slug}/`
+ *   })
+ */
+export declare function useHreflangLinks<T extends HreflangResource>(resource: MaybeRefOrGetter<T | null | undefined>, builder: (params: HreflangBuilderParams<T>) => string): void;
+//# sourceMappingURL=useHreflangLinks.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useHreflangLinks.d.ts","sourceRoot":"","sources":["../../../src/runtime/composables/useHreflangLinks.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,KAAK,CAAA;AAI3C,iCAAiC;AACjC,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAA;IACZ,iBAAiB,CAAC,EAAE,MAAM,EAAE,CAAA;IAC5B,eAAe,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CACzC;AAED,MAAM,WAAW,qBAAqB,CAAC,CAAC,SAAS,gBAAgB;IAC/D,8DAA8D;IAC9D,MAAM,EAAE,MAAM,GAAG,WAAW,CAAA;IAC5B,4CAA4C;IAC5C,IAAI,EAAE,MAAM,CAAA;IACZ,qDAAqD;IACrD,QAAQ,EAAE,CAAC,CAAA;CACZ;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,gBAAgB,CAAC,CAAC,SAAS,gBAAgB,EACzD,QAAQ,EAAE,gBAAgB,CAAC,CAAC,GAAG,IAAI,GAAG,SAAS,CAAC,EAChD,OAAO,EAAE,CAAC,MAAM,EAAE,qBAAqB,CAAC,CAAC,CAAC,KAAK,MAAM,QAgCtD"}

package/dist/runtime/composables/useHreflangLinks.js

@@ -0,0 +1,31 @@
+import { useHead } from "#imports";
+import { toValue } from "vue";
+export function useHreflangLinks(resource, builder) {
+  useHead({
+    link: () => {
+      const r = toValue(resource);
+      const locales = r?.available_locales;
+      if (!r || !locales || locales.length === 0)
+        return [];
+      const localized = r.localized_slugs ?? {};
+      const links = locales.map((locale) => ({
+        rel: "alternate",
+        hreflang: locale,
+        href: builder({
+          locale,
+          slug: localized[locale] ?? r.slug,
+          resource: r
+        }),
+        key: `cms-hreflang-${locale}`
+      }));
+      const defaultSlug = localized.en ?? localized[locales[0]] ?? r.slug;
+      links.push({
+        rel: "alternate",
+        hreflang: "x-default",
+        href: builder({ locale: "x-default", slug: defaultSlug, resource: r }),
+        key: "cms-hreflang-x-default"
+      });
+      return links;
+    }
+  });
+}

package/dist/runtime/plugins/preview-init.client.d.ts

@@ -0,0 +1,4 @@
+/** 从 cookie 恢复预览 token */
+declare const _default: unknown;
+export default _default;
+//# sourceMappingURL=preview-init.client.d.ts.map

package/dist/runtime/plugins/preview-init.client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"preview-init.client.d.ts","sourceRoot":"","sources":["../../../src/runtime/plugins/preview-init.client.ts"],"names":[],"mappings":"AAEA,0BAA0B;;AAC1B,wBAUE"}

package/dist/runtime/server/api/_revalidate.post.d.ts

@@ -0,0 +1,9 @@
+/** ISR 缓存失效端点 */
+declare const _default: import("h3").EventHandler<import("h3").EventHandlerRequest, Promise<{
+    success: boolean;
+    event: import("@vigilkids/cms-client").WebhookEventType;
+    paths_invalidated: string[];
+    cleared: number;
+}>>;
+export default _default;
+//# sourceMappingURL=_revalidate.post.d.ts.map

package/dist/runtime/server/api/_revalidate.post.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"_revalidate.post.d.ts","sourceRoot":"","sources":["../../../../src/runtime/server/api/_revalidate.post.ts"],"names":[],"mappings":"AAiCA,iBAAiB;;;;;;;AACjB,wBA4DE"}

package/dist/runtime/server/api/_revalidate.post.js

@@ -1,6 +1,19 @@
 import { useRuntimeConfig, useStorage } from "#imports";
 import { verifyWebhookSignature } from "@vigilkids/cms-client/webhook";
 import { createError, defineEventHandler, getHeader, readRawBody } from "h3";
+import { buildCmsPath, resolveCmsRoutePolicy } from "../../utils/routes.js";
+function addPath(paths, resource, routePolicy, params) {
+  try {
+    paths.add(buildCmsPath(routePolicy, resource, params, { includeLocale: true }));
+  } catch {
+  }
+}
+function publicLocale(locale, localeMap = {}) {
+  if (!locale)
+    return locale;
+  const match = Object.entries(localeMap).find(([, cmsLocale]) => cmsLocale === locale);
+  return match?.[0] ?? locale;
+}
 export default defineEventHandler(async (event) => {
   const config = useRuntimeConfig();
   const secret = config.cms.webhookSecret;
@@ -19,15 +32,22 @@ export default defineEventHandler(async (event) => {
     throw createError({ statusCode: 401, message: "Invalid webhook signature" });
   }
   const payload = JSON.parse(rawBody);
-  const paths = [];
-  const defaultLocale = config.public.cms.defaultLocale ?? "en";
-  const localePrefix = payload.locale && payload.locale !== defaultLocale ? `/${payload.locale}` : "";
-  if (payload.category_slug) {
-    paths.push(`${localePrefix}/${payload.category_slug}/${payload.slug}`);
-    paths.push(`${localePrefix}/${payload.category_slug}`);
-  }
-  paths.push(`${localePrefix}/blog/${payload.slug}`);
-  paths.push(`${localePrefix}/blog`);
+  const cmsConfig = config.public.cms;
+  const routePolicy = resolveCmsRoutePolicy(cmsConfig);
+  const routeParams = {
+    ...payload.route_params ?? {},
+    locale: publicLocale(payload.locale, cmsConfig.localeMap),
+    slug: payload.slug,
+    category_slug: payload.category_slug
+  };
+  const paths = /* @__PURE__ */ new Set();
+  addPath(paths, "index", routePolicy, routeParams);
+  if (routeParams.category_slug) {
+    addPath(paths, "category", routePolicy, routeParams);
+  }
+  if (routeParams.slug) {
+    addPath(paths, payload.resource_type || "article", routePolicy, routeParams);
+  }
   const storage = useStorage("cache:nitro:routes");
   const allKeys = await storage.getKeys("_:");
   let cleared = 0;
@@ -39,5 +59,5 @@ export default defineEventHandler(async (event) => {
       cleared++;
     }
   }
-  return { success: true, event: payload.event, paths_invalidated: paths, cleared };
+  return { success: true, event: payload.event, paths_invalidated: [...paths], cleared };
 });

package/dist/runtime/server/api/articles.get.d.ts

@@ -0,0 +1,4 @@
+import type { ArticleListItem, Paginated } from '@vigilkids/cms-client/types';
+declare const _default: import("h3").EventHandler<import("h3").EventHandlerRequest, Promise<Paginated<ArticleListItem>>>;
+export default _default;
+//# sourceMappingURL=articles.get.d.ts.map

package/dist/runtime/server/api/articles.get.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"articles.get.d.ts","sourceRoot":"","sources":["../../../../src/runtime/server/api/articles.get.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAEV,eAAe,EAEf,SAAS,EACV,MAAM,6BAA6B,CAAA;;AA0DpC,wBAiDE"}

package/dist/runtime/server/api/articles.get.js

@@ -0,0 +1,92 @@
+import { useRuntimeConfig } from "#imports";
+import { defineEventHandler, getQuery, setResponseHeader } from "h3";
+import { useServerCmsClient } from "../utils/cms-client.js";
+const DEFAULT_PAGE_SIZE = 20;
+const MAX_PAGE_SIZE = 20;
+function positiveInteger(value, fallback, max) {
+  const parsed = typeof value === "string" ? Number.parseInt(value, 10) : Number(value);
+  if (!Number.isFinite(parsed) || parsed < 1)
+    return fallback;
+  const normalized = Math.floor(parsed);
+  return max ? Math.min(normalized, max) : normalized;
+}
+function stringValue(value) {
+  return typeof value === "string" ? value.trim() : "";
+}
+function articleFromDetail(detail, fallback) {
+  return {
+    slug: detail.slug || fallback.slug,
+    title: detail.title || fallback.title,
+    excerpt: detail.excerpt || fallback.excerpt || "",
+    featured_image_url: detail.featured_image_url || fallback.featured_image_url || "",
+    featured_image_alt: detail.featured_image_alt || fallback.featured_image_alt || "",
+    published_at: detail.published_at ?? fallback.published_at ?? null,
+    last_published_at: detail.last_published_at ?? fallback.last_published_at ?? null,
+    reading_time_minutes: detail.reading_time_minutes || fallback.reading_time_minutes || 0,
+    category_slug: detail.category || fallback.category_slug,
+    is_pinned: false,
+    tags: detail.tags || fallback.tags || [],
+    authors: detail.authors || fallback.authors || []
+  };
+}
+function articleFromSearch(item) {
+  return {
+    slug: item.slug,
+    title: item.title,
+    excerpt: item.excerpt || "",
+    featured_image_url: item.featured_image_url || "",
+    featured_image_alt: item.featured_image_alt || "",
+    published_at: item.published_at ?? null,
+    last_published_at: item.last_published_at ?? null,
+    reading_time_minutes: item.reading_time_minutes || 0,
+    category_slug: item.category_slug,
+    is_pinned: false,
+    tags: item.tags || [],
+    authors: item.authors || []
+  };
+}
+function hasArticleCardFields(item) {
+  return Boolean(item.category_slug && item.featured_image_url && item.published_at && item.authors?.length);
+}
+export default defineEventHandler(async (event) => {
+  setResponseHeader(event, "Cache-Control", "private, no-cache, no-store");
+  const query = getQuery(event);
+  const page = positiveInteger(query.page, 1);
+  const pageSize = positiveInteger(query.page_size, DEFAULT_PAGE_SIZE, MAX_PAGE_SIZE);
+  const config = useRuntimeConfig();
+  const cmsConfig = config.public.cms;
+  const publicLocale = stringValue(query.locale) || cmsConfig.defaultLocale || "en";
+  const locale = cmsConfig.localeMap?.[publicLocale] ?? publicLocale;
+  const categorySlug = stringValue(query.category_slug);
+  const keyword = stringValue(query.q);
+  const client = useServerCmsClient();
+  if (!keyword) {
+    return await client.getArticles({
+      locale,
+      page,
+      page_size: pageSize,
+      sort_by: "published_at",
+      sort_order: "desc",
+      ...categorySlug ? { category_slug: categorySlug } : {}
+    });
+  }
+  const searchResponse = await client.searchArticles({
+    locale,
+    q: keyword,
+    page,
+    page_size: pageSize
+  });
+  const data = await Promise.all(
+    searchResponse.data.map(async (item) => {
+      if (hasArticleCardFields(item)) {
+        return articleFromSearch(item);
+      }
+      const detail = await client.getArticle(item.slug, locale);
+      return articleFromDetail(detail, item);
+    })
+  );
+  return {
+    data,
+    pagination: searchResponse.pagination
+  };
+});

package/dist/runtime/server/api/preview.get.d.ts

@@ -0,0 +1,4 @@
+/** 预览入口端点：验证 token、设置预览 cookie、重定向到对应语言的文章页 */
+declare const _default: import("h3").EventHandler<import("h3").EventHandlerRequest, Promise<void>>;
+export default _default;
+//# sourceMappingURL=preview.get.d.ts.map