@vigilkids/cms-nuxt 0.3.0 → 0.5.0

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

@@ -0,0 +1,16 @@
+import type { ArticleListItem } from '@vigilkids/cms-client/types';
+import type { ComputedRef, MaybeRefOrGetter } from 'vue';
+/** 文章详情 + 自动 SEO */
+export declare function useArticle(slug: MaybeRefOrGetter<string>): {
+    article: import("#imports").Ref<import("@vigilkids/cms-client").ArticleDetail | null, import("@vigilkids/cms-client").ArticleDetail | null>;
+    relatedArticles: ComputedRef<ArticleListItem[]>;
+    status: import("#imports").Ref<string, string>;
+    error: import("#imports").Ref<Error | null, Error | null>;
+    ready: {
+        data: import("#imports").Ref<import("@vigilkids/cms-client").ArticleDetail | null, import("@vigilkids/cms-client").ArticleDetail | null>;
+        status: import("#imports").Ref<string>;
+        error: import("#imports").Ref<Error | null>;
+        refresh: () => Promise<void>;
+    };
+};
+//# sourceMappingURL=useArticle.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useArticle.d.ts","sourceRoot":"","sources":["../../../src/runtime/composables/useArticle.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAA;AAClE,OAAO,KAAK,EAAE,WAAW,EAAE,gBAAgB,EAAE,MAAM,KAAK,CAAA;AAMxD,oBAAoB;AACpB,wBAAgB,UAAU,CAAC,IAAI,EAAE,gBAAgB,CAAC,MAAM,CAAC;;qBAoDd,WAAW,CAAC,eAAe,EAAE,CAAC;;;;;;;;;EAKxE"}

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,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

@@ -0,0 +1 @@
+{"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/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,188 @@
+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 分类预加载数据和路由工具 */
+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 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;
+        } | 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 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;
+        } | 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 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;
+        } | 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 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;
+        } | 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,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

@@ -0,0 +1,71 @@
+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 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) {
+        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, ""),
+      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
+    };
+  }
+  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 };
+}