@ubean/seo 0.4.4 → 0.4.6

package/dist/conventions.d.ts

@@ -2,8 +2,8 @@
 /**
  * 约定文件类型标识。每个标识映射到 srcDir 下的一个固定文件名和输出 URL。
  */
-type SeoConventionKind = 'sitemap' | 'robots' | 'manifest' | 'opengraph-image' | 'icon' | 'apple-icon';
-interface SeoConventionDescriptor {
+export type SeoConventionKind = 'sitemap' | 'robots' | 'manifest' | 'opengraph-image' | 'icon' | 'apple-icon';
+export interface SeoConventionDescriptor {
   kind: SeoConventionKind;
   /** srcDir 下的相对文件名(不含扩展名后缀,会尝试 .ts/.js/.mjs/.mts) */
   fileName: string;
@@ -14,23 +14,23 @@ interface SeoConventionDescriptor {
   /** 默认 `Cache-Control` */
   cacheControl: string;
 }
-declare const SEO_CONVENTIONS: readonly SeoConventionDescriptor[];
+export declare const SEO_CONVENTIONS: readonly SeoConventionDescriptor[];
 /**
  * 注册约定文件所需的最小 app 接口。`UbeanApp` 满足此接口,
  * 但为避免 `@ubean/seo` → `@ubean/app` 的硬依赖(后者已经依赖前者的兄弟包),
  * 此处用结构类型解耦。
  */
-interface SeoConventionApp {
+export interface SeoConventionApp {
   get(path: string, ...handlers: Array<(c: SeoConventionContext) => unknown>): unknown;
 }
-interface SeoConventionContext {
+export interface SeoConventionContext {
   req: {
     method: string;
     path: string;
     url: string;
   };
 }
-interface RegisterSeoConventionsOptions {
+export interface RegisterSeoConventionsOptions {
   /**
    * 项目 srcDir 绝对路径或相对 cwd 的路径。约定文件会在该目录根下查找。
    */
@@ -57,14 +57,14 @@ interface LoadedConvention {
  * 在 srcDir 下查找约定文件。返回已加载的 `{ descriptor, filePath, handler }` 列表;
  * 不存在的文件被静默跳过。
  */
-declare function discoverSeoConventions(options: RegisterSeoConventionsOptions): Promise<LoadedConvention[]>;
+export declare function discoverSeoConventions(options: RegisterSeoConventionsOptions): Promise<LoadedConvention[]>;
 /** Map `sitemap.ts` / `/src/robots.js` to a convention kind. */
-declare function conventionKindFromPath(filePath: string): SeoConventionKind | undefined;
+export declare function conventionKindFromPath(filePath: string): SeoConventionKind | undefined;
 /**
  * Register convention handlers already loaded (production `import.meta.glob`).
  * Keys may be absolute or vite-style paths; the basename selects the kind.
  */
-declare function registerSeoConventionModules(app: SeoConventionApp, modules: Record<string, {
+export declare function registerSeoConventionModules(app: SeoConventionApp, modules: Record<string, {
   default?: unknown;
 }>): Promise<SeoConventionKind[]>;
 /**
@@ -76,11 +76,10 @@ declare function registerSeoConventionModules(app: SeoConventionApp, modules: Re
  *
  * @returns 已注册的约定 kind 列表(便于日志/调试)
  */
-declare function registerSeoConventions(app: SeoConventionApp, options: RegisterSeoConventionsOptions): Promise<SeoConventionKind[]>;
+export declare function registerSeoConventions(app: SeoConventionApp, options: RegisterSeoConventionsOptions): Promise<SeoConventionKind[]>;
 /**
  * 列出 srcDir 下存在的约定文件 kind(不加载)。用于在不启动 app 的情况下
  * 检测项目使用了哪些约定(例如 CLI 信息展示)。
  */
-declare function listSeoConventions(options: Pick<RegisterSeoConventionsOptions, 'srcDir' | 'extensions'>): SeoConventionKind[];
-//#endregion
-export { RegisterSeoConventionsOptions, SEO_CONVENTIONS, SeoConventionApp, SeoConventionContext, SeoConventionDescriptor, SeoConventionKind, conventionKindFromPath, discoverSeoConventions, listSeoConventions, registerSeoConventionModules, registerSeoConventions };
+export declare function listSeoConventions(options: Pick<RegisterSeoConventionsOptions, 'srcDir' | 'extensions'>): SeoConventionKind[];
+//#endregion

package/dist/index.d.ts

@@ -1,25 +1,25 @@
 import { JsonLdInput, JsonLdSchema, defineJsonLd, mergeJsonLd, renderJsonLdScript, renderJsonLdScripts, schemaOrg, useSchemaOrg } from "./json-ld.js";
 import { UseSeoMetaInput } from "@unhead/vue";
 //#region src/index.d.ts
-interface RobotsOptions {
+export interface RobotsOptions {
   userAgent?: string;
   allow?: string | string[];
   disallow?: string | string[];
   sitemap?: string | string[];
   crawlDelay?: number;
 }
-interface SitemapUrl {
+export interface SitemapUrl {
   loc: string;
   lastmod?: string | Date;
   changefreq?: 'always' | 'hourly' | 'daily' | 'weekly' | 'monthly' | 'yearly' | 'never';
   priority?: number;
 }
-interface MetaTag {
+export interface MetaTag {
   name?: string;
   property?: string;
   content: string;
 }
-interface LinkTag {
+export interface LinkTag {
   rel: string;
   href: string;
   hreflang?: string;
@@ -29,7 +29,7 @@ interface LinkTag {
   as?: string;
   crossorigin?: '' | 'anonymous' | 'use-credentials';
 }
-interface OpenGraphMeta {
+export interface OpenGraphMeta {
   title?: string;
   description?: string;
   type?: 'website' | 'article' | 'book' | 'profile' | 'music.song' | 'music.album' | 'video.movie';
@@ -39,14 +39,14 @@ interface OpenGraphMeta {
   locale?: string;
   localeAlternate?: string[];
 }
-interface OGImage {
+export interface OGImage {
   url: string;
   width?: number;
   height?: number;
   alt?: string;
   type?: string;
 }
-interface TwitterMeta {
+export interface TwitterMeta {
   card?: 'summary' | 'summary_large_image' | 'app' | 'player';
   site?: string;
   creator?: string;
@@ -54,7 +54,7 @@ interface TwitterMeta {
   description?: string;
   image?: string;
 }
-interface SeoMetadata {
+export interface SeoMetadata {
   title?: string;
   titleTemplate?: string | ((title: string) => string);
   description?: string;
@@ -72,13 +72,13 @@ interface SeoMetadata {
   htmlAttrs?: Record<string, string>;
   bodyAttrs?: Record<string, string>;
 }
-interface ManifestIcon {
+export interface ManifestIcon {
   src: string;
   sizes: string;
   type: string;
   purpose?: string;
 }
-interface WebAppManifest {
+export interface WebAppManifest {
   name?: string;
   short_name?: string;
   description?: string;
@@ -92,20 +92,20 @@ interface WebAppManifest {
   lang?: string;
   dir?: 'ltr' | 'rtl' | 'auto';
 }
-declare function useSeoMeta<T extends Record<string, any>>(meta: T): T;
+export declare function useSeoMeta<T extends Record<string, any>>(meta: T): T;
 /**
  * 对 meta tag 数组去重(后定义覆盖先定义)。
  * 同 `name` 或同 `property` 的 tag 仅保留最后一个;无 name/property 的保留全部。
  * 不修改入参数组,返回新数组。
  */
-declare function dedupeMetaTags(tags: MetaTag[]): MetaTag[];
+export declare function dedupeMetaTags(tags: MetaTag[]): MetaTag[];
 /**
  * 对 link tag 数组去重(后定义覆盖先定义)。
  * 同 `rel`(+hreflang+type+sizes)的 link 仅保留最后一个;无 rel 的保留全部。
  * 不修改入参数组,返回新数组。
  */
-declare function dedupeLinkTags(tags: LinkTag[]): LinkTag[];
-declare function mergeMetadata(...metadatas: (SeoMetadata | undefined | null)[]): SeoMetadata;
+export declare function dedupeLinkTags(tags: LinkTag[]): LinkTag[];
+export declare function mergeMetadata(...metadatas: (SeoMetadata | undefined | null)[]): SeoMetadata;
 /**
  * 按"全局 → 布局 → 页面"优先级合并 SEO metadata(Task 8)。
  * 页面级覆盖布局级,布局级覆盖全局级;`meta`/`link` 数组自动去重(last-wins)。
@@ -113,19 +113,19 @@ declare function mergeMetadata(...metadatas: (SeoMetadata | undefined | null)[])
  * 与 `mergeMetadata` 的关系:`mergeSeoLayers(g, l, p)` 等价于
  * `mergeMetadata(g, l, p)`,仅以命名参数显式表达三层优先级,便于阅读。
  */
-declare function mergeSeoLayers(global?: SeoMetadata | null, layout?: SeoMetadata | null, page?: SeoMetadata | null): SeoMetadata;
-declare function buildMetaTags(meta: SeoMetadata): MetaTag[];
-declare function buildLinkTags(meta: SeoMetadata): LinkTag[];
-declare function buildTitle(meta: SeoMetadata, fallbackTitle?: string): string;
-declare function renderHeadTags(meta: SeoMetadata, fallbackTitle?: string): string;
-declare function createManifestResponse(manifest: WebAppManifest): Response;
-declare function defineManifest(manifest: WebAppManifest): WebAppManifest;
+export declare function mergeSeoLayers(global?: SeoMetadata | null, layout?: SeoMetadata | null, page?: SeoMetadata | null): SeoMetadata;
+export declare function buildMetaTags(meta: SeoMetadata): MetaTag[];
+export declare function buildLinkTags(meta: SeoMetadata): LinkTag[];
+export declare function buildTitle(meta: SeoMetadata, fallbackTitle?: string): string;
+export declare function renderHeadTags(meta: SeoMetadata, fallbackTitle?: string): string;
+export declare function createManifestResponse(manifest: WebAppManifest): Response;
+export declare function defineManifest(manifest: WebAppManifest): WebAppManifest;
 declare function formatRobotsTxt(options: RobotsOptions[] | RobotsOptions): string;
 declare function escapeXml(str: string): string;
 declare function formatSitemapXml(urls: SitemapUrl[]): string;
-declare function createRobotsResponse(options: RobotsOptions[] | RobotsOptions): Response;
-declare function createSitemapResponse(urls: SitemapUrl[]): Response;
-declare function defineRobotsConfig(config: RobotsOptions[] | RobotsOptions): RobotsOptions[] | RobotsOptions;
-declare function defineSitemapConfig(urls: SitemapUrl[] | (() => SitemapUrl[] | Promise<SitemapUrl[]>)): SitemapUrl[] | (() => SitemapUrl[] | Promise<SitemapUrl[]>);
+export declare function createRobotsResponse(options: RobotsOptions[] | RobotsOptions): Response;
+export declare function createSitemapResponse(urls: SitemapUrl[]): Response;
+export declare function defineRobotsConfig(config: RobotsOptions[] | RobotsOptions): RobotsOptions[] | RobotsOptions;
+export declare function defineSitemapConfig(urls: SitemapUrl[] | (() => SitemapUrl[] | Promise<SitemapUrl[]>)): SitemapUrl[] | (() => SitemapUrl[] | Promise<SitemapUrl[]>);
 //#endregion
-export { JsonLdInput, JsonLdSchema, LinkTag, ManifestIcon, MetaTag, OGImage, OpenGraphMeta, RobotsOptions, SeoMetadata, SitemapUrl, TwitterMeta, type UseSeoMetaInput, WebAppManifest, buildLinkTags, buildMetaTags, buildTitle, createManifestResponse, createRobotsResponse, createSitemapResponse, dedupeLinkTags, dedupeMetaTags, defineJsonLd, defineManifest, defineRobotsConfig, defineSitemapConfig, escapeXml, formatRobotsTxt, formatSitemapXml, mergeJsonLd, mergeMetadata, mergeSeoLayers, renderHeadTags, renderJsonLdScript, renderJsonLdScripts, schemaOrg, useSchemaOrg, useSeoMeta };
+export { JsonLdInput, JsonLdSchema, type UseSeoMetaInput, defineJsonLd, escapeXml, formatRobotsTxt, formatSitemapXml, mergeJsonLd, renderJsonLdScript, renderJsonLdScripts, schemaOrg, useSchemaOrg };

package/dist/json-ld.d.ts

@@ -19,11 +19,11 @@
 /**
  * 任意 JSON-LD 节点。必须是可序列化对象,通常包含 `@context` 和 `@type`。
  */
-type JsonLdSchema = Record<string, unknown>;
+export type JsonLdSchema = Record<string, unknown>;
 /**
  * JSON-LD schema 输入:可以是对象、对象数组,或返回对象/数组的函数。
  */
-type JsonLdInput = JsonLdSchema | JsonLdSchema[] | (() => JsonLdSchema | JsonLdSchema[] | Promise<JsonLdSchema | JsonLdSchema[]>);
+export type JsonLdInput = JsonLdSchema | JsonLdSchema[] | (() => JsonLdSchema | JsonLdSchema[] | Promise<JsonLdSchema | JsonLdSchema[]>);
 /**
  * 渲染为 `<script type="application/ld+json">` HTML 字符串。
  *
@@ -37,13 +37,13 @@ type JsonLdInput = JsonLdSchema | JsonLdSchema[] | (() => JsonLdSchema | JsonLdS
  * // => <script type="application/ld+json">{"@context":"https://schema.org","@type":"Organization","name":"ubean"}</script>
  * ```
  */
-declare function renderJsonLdScript(schema: JsonLdSchema | JsonLdSchema[]): string;
+export declare function renderJsonLdScript(schema: JsonLdSchema | JsonLdSchema[]): string;
 /**
  * 把多个 JSON-LD schema 合并为 `@graph` 数组(对齐 schema.org 推荐做法)。
  *
  * 若输入只有一个 schema,直接返回(避免不必要的 @graph 包装)。
  */
-declare function mergeJsonLd(schemas: JsonLdSchema[]): JsonLdSchema | JsonLdSchema[];
+export declare function mergeJsonLd(schemas: JsonLdSchema[]): JsonLdSchema | JsonLdSchema[];
 /**
  * 定义一个 JSON-LD schema(纯函数,无副作用)。
  *
@@ -59,7 +59,7 @@ declare function mergeJsonLd(schemas: JsonLdSchema[]): JsonLdSchema | JsonLdSche
  * renderJsonLdScript(org)
  * ```
  */
-declare function defineJsonLd(schema: JsonLdInput): JsonLdInput;
+export declare function defineJsonLd(schema: JsonLdInput): JsonLdInput;
 /**
  * Vue composable:把 JSON-LD schema 注入到 head(通过 `useHead`)。
  *
@@ -77,15 +77,15 @@ declare function defineJsonLd(schema: JsonLdInput): JsonLdInput;
  * </script>
  * ```
  */
-declare function useSchemaOrg(schema: JsonLdInput): JsonLdInput;
+export declare function useSchemaOrg(schema: JsonLdInput): JsonLdInput;
 /**
  * 把多个 JSON-LD schema 渲染为 `<script>` 标签数组(SSR 用)。
  */
-declare function renderJsonLdScripts(schemas: JsonLdSchema[]): string;
+export declare function renderJsonLdScripts(schemas: JsonLdSchema[]): string;
 /**
  * 常见 Schema.org 类型的便捷工厂函数(覆盖 80% 用例)。
  */
-declare const schemaOrg: {
+export declare const schemaOrg: {
   organization(options: {
     name: string;
     url?: string;
@@ -118,5 +118,4 @@ declare const schemaOrg: {
     availability?: "InStock" | "OutOfStock" | "PreOrder";
   }): JsonLdSchema;
 };
-//#endregion
-export { JsonLdInput, JsonLdSchema, defineJsonLd, mergeJsonLd, renderJsonLdScript, renderJsonLdScripts, schemaOrg, useSchemaOrg };
+//#endregion

package/dist/og-image.d.ts

@@ -5,7 +5,7 @@
  *
  * 形状与 React.createElement 返回值兼容:`{ type, props: { children, style, ... } }`。
  */
-interface SatoriNode {
+export interface SatoriNode {
   type: string;
   props: {
     children?: SatoriNode | SatoriNode[] | string;
@@ -16,7 +16,7 @@ interface SatoriNode {
 /**
  * Satori 字体描述符。
  */
-interface SatoriFont {
+export interface SatoriFont {
   name: string;
   data: ArrayBuffer | Buffer;
   weight?: 100 | 200 | 300 | 400 | 500 | 600 | 700 | 800 | 900;
@@ -25,7 +25,7 @@ interface SatoriFont {
 /**
  * `ImageResponse` / `renderOgImage` 共享的渲染选项。
  */
-interface OgImageOptions {
+export interface OgImageOptions {
   /** 图像宽度(px)。默认 1200。 */
   width?: number;
   /** 图像高度(px)。默认 630。 */
@@ -56,7 +56,7 @@ interface OgImageOptions {
 /**
  * 内置模板的输入参数。
  */
-interface OgTemplateInput {
+export interface OgTemplateInput {
   /** 主标题(必填)。 */
   title: string;
   /** 副标题/描述。 */
@@ -77,11 +77,11 @@ interface OgTemplateInput {
  *
  * 在生产环境建议使用 `loadFontFromFile()` 加载本地字体,避免运行时网络依赖。
  */
-declare const DEFAULT_FONT_URL = "https://fonts.gstatic.com/s/inter/v12/UcCO3FwrK3iLTeHuS_fvQtMwCp50KnMa1ZL7.woff2";
+export declare const DEFAULT_FONT_URL = "https://fonts.gstatic.com/s/inter/v12/UcCO3FwrK3iLTeHuS_fvQtMwCp50KnMa1ZL7.woff2";
 /**
  * 默认字体名。
  */
-declare const DEFAULT_FONT_NAME = "Inter";
+export declare const DEFAULT_FONT_NAME = "Inter";
 /**
  * 从 URL 加载字体(返回 Satori 兼容的 `SatoriFont`)。
  *
@@ -90,7 +90,7 @@ declare const DEFAULT_FONT_NAME = "Inter";
  * const font = await loadFontFromUrl('https://fonts.gstatic.com/.../inter.woff2', 'Inter');
  * ```
  */
-declare function loadFontFromUrl(url: string, name: string, weight?: SatoriFont['weight'], fontStyle?: SatoriFont['style']): Promise<SatoriFont>;
+export declare function loadFontFromUrl(url: string, name: string, weight?: SatoriFont['weight'], fontStyle?: SatoriFont['style']): Promise<SatoriFont>;
 /**
  * 从本地文件加载字体。
  *
@@ -99,24 +99,24 @@ declare function loadFontFromUrl(url: string, name: string, weight?: SatoriFont[
  * const font = loadFontFromFile('./fonts/inter-regular.woff2', 'Inter');
  * ```
  */
-declare function loadFontFromFile(path: string, name: string, weight?: SatoriFont['weight'], fontStyle?: SatoriFont['style']): SatoriFont;
+export declare function loadFontFromFile(path: string, name: string, weight?: SatoriFont['weight'], fontStyle?: SatoriFont['style']): SatoriFont;
 /**
  * 加载默认字体(Inter Regular,从 Google Fonts CDN 拉取)。
  *
  * 注意:此函数依赖网络访问。Cloudflare Workers 等边缘环境需要 fetch API 可用。
  * 离线/生产环境推荐用 `loadFontFromFile()` 替代。
  */
-declare function loadDefaultFont(): Promise<SatoriFont>;
+export declare function loadDefaultFont(): Promise<SatoriFont>;
 /**
  * 默认 OG 图模板:渐变背景 + 居中标题 + 副标题 + 底部站点名。
  *
  * 返回 Satori 兼容的 VDOM 树。
  */
-declare function defaultTemplate(input: OgTemplateInput): SatoriNode;
+export declare function defaultTemplate(input: OgTemplateInput): SatoriNode;
 /**
  * 文章模板:左对齐标题 + 日期/作者元信息。
  */
-declare function articleTemplate(input: OgTemplateInput & {
+export declare function articleTemplate(input: OgTemplateInput & {
   author?: string;
   date?: string;
 }): SatoriNode;
@@ -125,13 +125,13 @@ declare function articleTemplate(input: OgTemplateInput & {
  *
  * `percent` 为负数调暗,正数调亮。范围 -100..100。
  */
-declare function shadeColor(hex: string, percent: number): string;
+export declare function shadeColor(hex: string, percent: number): string;
 /**
  * 把 Satori VDOM 节点渲染为 PNG Buffer(或 SVG 字符串,当 `svgOnly: true` 时)。
  *
  * @returns `{ body, contentType }` —— body 为 Buffer/字符串,contentType 为 MIME 类型
  */
-declare function renderToImage(node: SatoriNode, options?: OgImageOptions): Promise<{
+export declare function renderToImage(node: SatoriNode, options?: OgImageOptions): Promise<{
   body: Buffer | string;
   contentType: string;
 }>;
@@ -164,7 +164,7 @@ declare function renderToImage(node: SatoriNode, options?: OgImageOptions): Prom
  * }
  * ```
  */
-declare class ImageResponse extends Response {
+export declare class ImageResponse extends Response {
   constructor(node: SatoriNode, options?: OgImageOptions);
 }
 /**
@@ -179,11 +179,11 @@ declare class ImageResponse extends Response {
  * });
  * ```
  */
-declare function renderOgImage(input: OgTemplateInput, options?: OgImageOptions): Promise<Response>;
+export declare function renderOgImage(input: OgTemplateInput, options?: OgImageOptions): Promise<Response>;
 /**
  * 用文章模板渲染 OG 图。
  */
-declare function renderArticleOgImage(input: OgTemplateInput & {
+export declare function renderArticleOgImage(input: OgTemplateInput & {
   author?: string;
   date?: string;
 }, options?: OgImageOptions): Promise<Response>;
@@ -191,6 +191,5 @@ declare function renderArticleOgImage(input: OgTemplateInput & {
  * 检测运行时是否安装了 OG 图渲染所需的依赖。
  * 用于在不实际渲染的情况下判断能力可用性(例如 DevTools 信息展示)。
  */
-declare function isOgImageSupported(): Promise<boolean>;
-//#endregion
-export { DEFAULT_FONT_NAME, DEFAULT_FONT_URL, ImageResponse, OgImageOptions, OgTemplateInput, SatoriFont, SatoriNode, articleTemplate, defaultTemplate, isOgImageSupported, loadDefaultFont, loadFontFromFile, loadFontFromUrl, renderArticleOgImage, renderOgImage, renderToImage, shadeColor };
+export declare function isOgImageSupported(): Promise<boolean>;
+//#endregion

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ubean/seo",
-  "version": "0.4.4",
+  "version": "0.4.6",
   "description": "SEO utilities for ubean (useSeoMeta, robots, sitemap, manifest, file conventions, JSON-LD, OG image)",
   "files": [
     "dist"
@@ -33,8 +33,8 @@
   },
   "devDependencies": {
     "@types/node": "^26.5.0",
-    "typescript": "7.0.2",
-    "vite-plus": "0.3.0"
+    "typescript": "npm:typescript-native-bridge@latest",
+    "vite-plus": "0.3.1"
   },
   "peerDependencies": {
     "@resvg/resvg-js": "^2.6.0",