@ubean/seo 0.5.2 → 0.6.0-beta.2

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-import { JsonLdInput, JsonLdSchema, defineJsonLd, mergeJsonLd, renderJsonLdScript, renderJsonLdScripts, schemaOrg, useSchemaOrg } from "./json-ld.js";
+import { JsonLdInput, JsonLdSchema, defineJsonLd, mergeJsonLd, renderJsonLdScript, renderJsonLdScripts, resetSchemaOrgWarning, schemaOrg, serializeJsonLd, useSchemaOrg } from "./json-ld.js";
 import { UseSeoMetaInput } from "@unhead/vue";
 //#region src/index.d.ts
 export interface RobotsOptions {
@@ -128,4 +128,4 @@ 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, type UseSeoMetaInput, defineJsonLd, escapeXml, formatRobotsTxt, formatSitemapXml, mergeJsonLd, renderJsonLdScript, renderJsonLdScripts, schemaOrg, useSchemaOrg };
+export { JsonLdInput, JsonLdSchema, type UseSeoMetaInput, defineJsonLd, escapeXml, formatRobotsTxt, formatSitemapXml, mergeJsonLd, renderJsonLdScript, renderJsonLdScripts, resetSchemaOrgWarning, schemaOrg, serializeJsonLd, useSchemaOrg };

package/dist/index.js

@@ -1,4 +1,4 @@
-import { defineJsonLd, mergeJsonLd, renderJsonLdScript, renderJsonLdScripts, schemaOrg, useSchemaOrg } from "./json-ld.js";
+import { defineJsonLd, mergeJsonLd, renderJsonLdScript, renderJsonLdScripts, resetSchemaOrgWarning, schemaOrg, serializeJsonLd, useSchemaOrg } from "./json-ld.js";
 import { useSeoMeta as useSeoMeta$1 } from "@unhead/vue";
 //#region src/index.ts
 function useSeoMeta(meta) {
@@ -356,4 +356,4 @@ function defineSitemapConfig(urls) {
 	return urls;
 }
 //#endregion
-export { 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 { buildLinkTags, buildMetaTags, buildTitle, createManifestResponse, createRobotsResponse, createSitemapResponse, dedupeLinkTags, dedupeMetaTags, defineJsonLd, defineManifest, defineRobotsConfig, defineSitemapConfig, escapeXml, formatRobotsTxt, formatSitemapXml, mergeJsonLd, mergeMetadata, mergeSeoLayers, renderHeadTags, renderJsonLdScript, renderJsonLdScripts, resetSchemaOrgWarning, schemaOrg, serializeJsonLd, useSchemaOrg, useSeoMeta };

package/dist/json-ld.d.ts

@@ -38,6 +38,13 @@ export type JsonLdInput = JsonLdSchema | JsonLdSchema[] | (() => JsonLdSchema |
  * ```
  */
 export declare function renderJsonLdScript(schema: JsonLdSchema | JsonLdSchema[]): string;
+/**
+ * 把 schema 序列化为**可安全内联进 HTML/JS 字符串**的 JSON。
+ *
+ * 转义 `</script>`、U+2028/U+2029 —— 与 `renderJsonLdScript()` 是同一份实现，供 Vue 侧的
+ * `useSchemaOrg()`（把内容交给 head 的 `textContent`）复用，避免两处转义规则漂移。
+ */
+export declare function serializeJsonLd(schema: JsonLdSchema | JsonLdSchema[]): string;
 /**
  * 把多个 JSON-LD schema 合并为 `@graph` 数组(对齐 schema.org 推荐做法)。
  *
@@ -61,22 +68,10 @@ export declare function mergeJsonLd(schemas: JsonLdSchema[]): JsonLdSchema | Jso
  */
 export declare function defineJsonLd(schema: JsonLdInput): JsonLdInput;
 /**
- * Vue composable:把 JSON-LD schema 注入到 head(通过 `useHead`)。
- *
- * 在非 Vue setup 上下文中静默降级(返回 schema 本身),不抛错。
- *
- * @example
- * ```vue
- * <script setup>
- * useSchemaOrg({
- *   '@context': 'https://schema.org',
- *   '@type': 'Article',
- *   headline: 'My Article',
- *   author: { '@type': 'Person', name: 'John' }
- * });
- * </script>
- * ```
+ * 重置「缺 head」告警标志。**仅供测试**（与 `@ubean/vue` 的 `clearMatchers()` 同一用途）：
+ * 标志是模块级单例，一条用例触发过告警后，后续用例就观察不到它了。
  */
+export declare function resetSchemaOrgWarning(): void;
 export declare function useSchemaOrg(schema: JsonLdInput): JsonLdInput;
 /**
  * 把多个 JSON-LD schema 渲染为 `<script>` 标签数组(SSR 用)。
@@ -101,6 +96,8 @@ export declare const schemaOrg: {
     headline: string;
     author: string;
     datePublished: string;
+    /** Article 经 CreativeWork 继承的标准属性；Google 的 Article 富结果会读它。 */
+    description?: string;
     image?: string;
     publisher?: string;
   }): JsonLdSchema;

package/dist/json-ld.js

@@ -13,7 +13,16 @@
 * ```
 */
 function renderJsonLdScript(schema) {
-	return `<script type="application/ld+json">${JSON.stringify(schema).replace(/</g, "\\u003c").replace(/>/g, "\\u003e").replace(/\u2028/g, "\\u2028").replace(/\u2029/g, "\\u2029")}<\/script>`;
+	return `<script type="application/ld+json">${serializeJsonLd(schema)}<\/script>`;
+}
+/**
+* 把 schema 序列化为**可安全内联进 HTML/JS 字符串**的 JSON。
+*
+* 转义 `<\/script>`、U+2028/U+2029 —— 与 `renderJsonLdScript()` 是同一份实现，供 Vue 侧的
+* `useSchemaOrg()`（把内容交给 head 的 `textContent`）复用，避免两处转义规则漂移。
+*/
+function serializeJsonLd(schema) {
+	return JSON.stringify(schema).replace(/</g, "\\u003c").replace(/>/g, "\\u003e").replace(/\u2028/g, "\\u2028").replace(/\u2029/g, "\\u2029");
 }
 /**
 * 把多个 JSON-LD schema 合并为 `@graph` 数组(对齐 schema.org 推荐做法)。
@@ -64,17 +73,27 @@ function defineJsonLd(schema) {
 * <\/script>
 * ```
 */
+let warnedMissingHead = false;
+/**
+* 重置「缺 head」告警标志。**仅供测试**（与 `@ubean/vue` 的 `clearMatchers()` 同一用途）：
+* 标志是模块级单例，一条用例触发过告警后，后续用例就观察不到它了。
+*/
+function resetSchemaOrgWarning() {
+	warnedMissingHead = false;
+}
 function useSchemaOrg(schema) {
-	try {
-		const head = globalThis.__UBEAN_HEAD__;
-		if (head && typeof head.push === "function") {
-			const scriptContent = typeof schema === "function" ? JSON.stringify(schema) : JSON.stringify(schema);
-			head.push({ script: [{
-				type: "application/ld+json",
-				innerHTML: scriptContent
-			}] });
-		}
-	} catch {}
+	const head = globalThis.__UBEAN_HEAD__;
+	if (head && typeof head.push === "function") {
+		head.push({ script: [{
+			type: "application/ld+json",
+			textContent: serializeJsonLd(schema)
+		}] });
+		return schema;
+	}
+	if (!warnedMissingHead) {
+		warnedMissingHead = true;
+		console.warn("[ubean] useSchemaOrg(): 当前没有 head 实例，JSON-LD 未注入。Vue 应用请从 `ubean/client` 导入 （它走 @unhead/vue 的 useHead）；非 Vue 环境请用 `renderJsonLdScript()` 自行注入。");
+	}
 	return schema;
 }
 /**
@@ -116,6 +135,7 @@ const schemaOrg = {
 				name: options.author
 			},
 			datePublished: options.datePublished,
+			...options.description ? { description: options.description } : {},
 			...options.image ? { image: options.image } : {},
 			...options.publisher ? { publisher: {
 				"@type": "Organization",
@@ -156,4 +176,4 @@ const schemaOrg = {
 	}
 };
 //#endregion
-export { defineJsonLd, mergeJsonLd, renderJsonLdScript, renderJsonLdScripts, schemaOrg, useSchemaOrg };
+export { defineJsonLd, mergeJsonLd, renderJsonLdScript, renderJsonLdScripts, resetSchemaOrgWarning, schemaOrg, serializeJsonLd, useSchemaOrg };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ubean/seo",
-  "version": "0.5.2",
+  "version": "0.6.0-beta.2",
   "description": "SEO utilities for ubean (useSeoMeta, robots, sitemap, manifest, file conventions, JSON-LD, OG image)",
   "files": [
     "dist"
@@ -28,13 +28,13 @@
     }
   },
   "dependencies": {
-    "@unhead/vue": "^3.4.0",
+    "@unhead/vue": "^3.4.1",
     "pathe": "^2.0.3"
   },
   "devDependencies": {
-    "@types/node": "^26.5.0",
+    "@types/node": "^26.6.1",
     "typescript": "npm:typescript-native-bridge@latest",
-    "vite-plus": "0.3.1"
+    "vite-plus": "0.3.3"
   },
   "peerDependencies": {
     "@resvg/resvg-js": "^2.6.0",