@lytjs/metadata 6.6.0

package/README.md

@@ -0,0 +1,41 @@
+# @lytjs/metadata
+
+> LytJS 元数据管理系统。
+
+[![npm version](https://img.shields.io/npm/v/@lytjs/metadata.svg)](https://www.npmjs.com/package/@lytjs/metadata)
+[![license](https://img.shields.io/npm/l/@lytjs/metadata.svg)](https://gitee.com/lytjs/lytjs/blob/main/LICENSE)
+
+## 简介
+
+`@lytjs/metadata` 是 LytJS 框架的元数据管理系统，支持 HTML meta 标签、OpenGraph、Twitter Cards 等。
+
+### 核心特性
+
+- **链式 API**：流畅的链式调用方式
+- **OpenGraph 支持**：完整的 OpenGraph 元数据
+- **Twitter Cards 支持**：支持 Twitter 卡片
+- **SEO 优化**：自动处理 SEO 相关元数据
+- **零依赖**：不引入任何外部依赖
+
+## 安装
+
+```bash
+npm install @lytjs/metadata
+```
+
+或使用 pnpm：
+
+```bash
+pnpm add @lytjs/metadata
+```
+
+## 许可证
+
+MIT License - [查看许可证](https://gitee.com/lytjs/lytjs/blob/main/LICENSE)
+
+## 贡献指南
+
+欢迎提交 Issue 和 Pull Request！
+
+- [Gitee 仓库](https://gitee.com/lytjs/lytjs)
+- [问题反馈](https://gitee.com/lytjs/lytjs/issues)

package/dist/index.cjs

@@ -0,0 +1,120 @@
+'use strict';
+
+var commonString = require('@lytjs/common-string');
+
+var __defProp = Object.defineProperty;
+var __defNormalProp = (obj, key, value) => key in obj ? __defProp(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
+var __publicField = (obj, key, value) => __defNormalProp(obj, key + "" , value);
+
+// src/builder.ts
+var MetadataBuilder = class {
+  constructor() {
+    /** 元数据对象 */
+    __publicField(this, "metadata", {});
+  }
+  /**
+   * 设置标题
+   *
+   * @param title - 标题
+   * @returns 构建器实例
+   */
+  title(title) {
+    this.metadata.title = title;
+    return this;
+  }
+  /**
+   * 设置描述
+   *
+   * @param description - 描述
+   * @returns 构建器实例
+   */
+  description(description) {
+    this.metadata.description = description;
+    return this;
+  }
+  /**
+   * 设置关键词
+   *
+   * @param keywords - 关键词数组
+   * @returns 构建器实例
+   */
+  keywords(keywords) {
+    this.metadata.keywords = keywords;
+    return this;
+  }
+  /**
+   * 设置 Open Graph 元数据
+   *
+   * @param og - Open Graph 元数据
+   * @returns 构建器实例
+   */
+  openGraph(og) {
+    this.metadata.openGraph = { ...this.metadata.openGraph, ...og };
+    return this;
+  }
+  /**
+   * 设置 Twitter 元数据
+   *
+   * @param twitter - Twitter 元数据
+   * @returns 构建器实例
+   */
+  twitter(twitter) {
+    this.metadata.twitter = { ...this.metadata.twitter, ...twitter };
+    return this;
+  }
+  /**
+   * 设置自定义属性
+   *
+   * @param key - 键
+   * @param value - 值
+   * @returns 构建器实例
+   */
+  set(key, value) {
+    this.metadata[key] = value;
+    return this;
+  }
+  /**
+   * 构建元数据
+   *
+   * @returns 元数据对象
+   */
+  build() {
+    return { ...this.metadata };
+  }
+};
+function createMetadataBuilder() {
+  return new MetadataBuilder();
+}
+function renderMetadata(metadata) {
+  const tags = [];
+  if (metadata.title) {
+    tags.push(`<title>${commonString.escapeHTML(metadata.title)}</title>`);
+  }
+  if (metadata.description) {
+    tags.push(`<meta name="description" content="${commonString.escapeHTML(metadata.description)}">`);
+  }
+  if (metadata.keywords && metadata.keywords.length > 0) {
+    tags.push(`<meta name="keywords" content="${commonString.escapeHTML(metadata.keywords.join(", "))}">`);
+  }
+  if (metadata.openGraph) {
+    for (const [key, value] of Object.entries(metadata.openGraph)) {
+      if (value) {
+        tags.push(`<meta property="og:${key}" content="${commonString.escapeHTML(String(value))}">`);
+      }
+    }
+  }
+  if (metadata.twitter) {
+    for (const [key, value] of Object.entries(metadata.twitter)) {
+      if (value) {
+        tags.push(`<meta name="twitter:${key}" content="${commonString.escapeHTML(String(value))}">`);
+      }
+    }
+  }
+  return tags.join("\n");
+}
+
+exports.MetadataBuilder = MetadataBuilder;
+exports.createMetadataBuilder = createMetadataBuilder;
+exports.renderMetadata = renderMetadata;
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/builder.ts","../src/renderer.ts"],"names":["escapeHTML"],"mappings":";;;;;;;;;AAQO,IAAM,kBAAN,MAAsB;AAAA,EAAtB,WAAA,GAAA;AAEL;AAAA,IAAA,aAAA,CAAA,IAAA,EAAQ,YAAqB,EAAC,CAAA;AAAA,EAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQ9B,MAAM,KAAA,EAAqB;AACzB,IAAA,IAAA,CAAK,SAAS,KAAA,GAAQ,KAAA;AACtB,IAAA,OAAO,IAAA;AAAA,EACT;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQA,YAAY,WAAA,EAA2B;AACrC,IAAA,IAAA,CAAK,SAAS,WAAA,GAAc,WAAA;AAC5B,IAAA,OAAO,IAAA;AAAA,EACT;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQA,SAAS,QAAA,EAA0B;AACjC,IAAA,IAAA,CAAK,SAAS,QAAA,GAAW,QAAA;AACzB,IAAA,OAAO,IAAA;AAAA,EACT;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQA,UAAU,EAAA,EAA6B;AACrC,IAAA,IAAA,CAAK,QAAA,CAAS,YAAY,EAAE,GAAG,KAAK,QAAA,CAAS,SAAA,EAAW,GAAG,EAAA,EAAG;AAC9D,IAAA,OAAO,IAAA;AAAA,EACT;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQA,QAAQ,OAAA,EAAgC;AACtC,IAAA,IAAA,CAAK,QAAA,CAAS,UAAU,EAAE,GAAG,KAAK,QAAA,CAAS,OAAA,EAAS,GAAG,OAAA,EAAQ;AAC/D,IAAA,OAAO,IAAA;AAAA,EACT;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EASA,GAAA,CAAI,KAAa,KAAA,EAAsB;AACrC,IAAA,IAAA,CAAK,QAAA,CAAS,GAAG,CAAA,GAAI,KAAA;AACrB,IAAA,OAAO,IAAA;AAAA,EACT;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOA,KAAA,GAAkB;AAChB,IAAA,OAAO,EAAE,GAAG,IAAA,CAAK,QAAA,EAAS;AAAA,EAC5B;AACF;AAOO,SAAS,qBAAA,GAAyC;AACvD,EAAA,OAAO,IAAI,eAAA,EAAgB;AAC7B;ACpFO,SAAS,eAAe,QAAA,EAA4B;AACzD,EAAA,MAAM,OAAiB,EAAC;AAExB,EAAA,IAAI,SAAS,KAAA,EAAO;AAClB,IAAA,IAAA,CAAK,KAAK,CAAA,OAAA,EAAUA,uBAAA,CAAW,QAAA,CAAS,KAAK,CAAC,CAAA,QAAA,CAAU,CAAA;AAAA,EAC1D;AAEA,EAAA,IAAI,SAAS,WAAA,EAAa;AACxB,IAAA,IAAA,CAAK,KAAK,CAAA,kCAAA,EAAqCA,uBAAA,CAAW,QAAA,CAAS,WAAW,CAAC,CAAA,EAAA,CAAI,CAAA;AAAA,EACrF;AAEA,EAAA,IAAI,QAAA,CAAS,QAAA,IAAY,QAAA,CAAS,QAAA,CAAS,SAAS,CAAA,EAAG;AACrD,IAAA,IAAA,CAAK,IAAA,CAAK,kCAAkCA,uBAAA,CAAW,QAAA,CAAS,SAAS,IAAA,CAAK,IAAI,CAAC,CAAC,CAAA,EAAA,CAAI,CAAA;AAAA,EAC1F;AAEA,EAAA,IAAI,SAAS,SAAA,EAAW;AACtB,IAAA,KAAA,MAAW,CAAC,KAAK,KAAK,CAAA,IAAK,OAAO,OAAA,CAAQ,QAAA,CAAS,SAAS,CAAA,EAAG;AAC7D,MAAA,IAAI,KAAA,EAAO;AACT,QAAA,IAAA,CAAK,IAAA,CAAK,sBAAsB,GAAG,CAAA,WAAA,EAAcA,wBAAW,MAAA,CAAO,KAAK,CAAC,CAAC,CAAA,EAAA,CAAI,CAAA;AAAA,MAChF;AAAA,IACF;AAAA,EACF;AAEA,EAAA,IAAI,SAAS,OAAA,EAAS;AACpB,IAAA,KAAA,MAAW,CAAC,KAAK,KAAK,CAAA,IAAK,OAAO,OAAA,CAAQ,QAAA,CAAS,OAAO,CAAA,EAAG;AAC3D,MAAA,IAAI,KAAA,EAAO;AACT,QAAA,IAAA,CAAK,IAAA,CAAK,uBAAuB,GAAG,CAAA,WAAA,EAAcA,wBAAW,MAAA,CAAO,KAAK,CAAC,CAAC,CAAA,EAAA,CAAI,CAAA;AAAA,MACjF;AAAA,IACF;AAAA,EACF;AAEA,EAAA,OAAO,IAAA,CAAK,KAAK,IAAI,CAAA;AACvB","file":"index.cjs","sourcesContent":["/**\n * 元数据构建器\n */\nimport type { Metadata, OpenGraphMetadata, TwitterMetadata } from '@lytjs/shared-types';\n\n/**\n * 元数据构建器类\n */\nexport class MetadataBuilder {\n  /** 元数据对象 */\n  private metadata: Metadata = {};\n\n  /**\n   * 设置标题\n   *\n   * @param title - 标题\n   * @returns 构建器实例\n   */\n  title(title: string): this {\n    this.metadata.title = title;\n    return this;\n  }\n\n  /**\n   * 设置描述\n   *\n   * @param description - 描述\n   * @returns 构建器实例\n   */\n  description(description: string): this {\n    this.metadata.description = description;\n    return this;\n  }\n\n  /**\n   * 设置关键词\n   *\n   * @param keywords - 关键词数组\n   * @returns 构建器实例\n   */\n  keywords(keywords: string[]): this {\n    this.metadata.keywords = keywords;\n    return this;\n  }\n\n  /**\n   * 设置 Open Graph 元数据\n   *\n   * @param og - Open Graph 元数据\n   * @returns 构建器实例\n   */\n  openGraph(og: OpenGraphMetadata): this {\n    this.metadata.openGraph = { ...this.metadata.openGraph, ...og };\n    return this;\n  }\n\n  /**\n   * 设置 Twitter 元数据\n   *\n   * @param twitter - Twitter 元数据\n   * @returns 构建器实例\n   */\n  twitter(twitter: TwitterMetadata): this {\n    this.metadata.twitter = { ...this.metadata.twitter, ...twitter };\n    return this;\n  }\n\n  /**\n   * 设置自定义属性\n   *\n   * @param key - 键\n   * @param value - 值\n   * @returns 构建器实例\n   */\n  set(key: string, value: unknown): this {\n    this.metadata[key] = value;\n    return this;\n  }\n\n  /**\n   * 构建元数据\n   *\n   * @returns 元数据对象\n   */\n  build(): Metadata {\n    return { ...this.metadata };\n  }\n}\n\n/**\n * 创建元数据构建器\n *\n * @returns 构建器实例\n */\nexport function createMetadataBuilder(): MetadataBuilder {\n  return new MetadataBuilder();\n}\n","/**\n * 元数据渲染器\n */\nimport type { Metadata } from '@lytjs/shared-types';\nimport { escapeHTML } from '@lytjs/common-string';\n\n/**\n * 渲染元数据为 HTML 标签\n *\n * @param metadata - 元数据对象\n * @returns HTML 标签字符串\n */\nexport function renderMetadata(metadata: Metadata): string {\n  const tags: string[] = [];\n\n  if (metadata.title) {\n    tags.push(`<title>${escapeHTML(metadata.title)}</title>`);\n  }\n\n  if (metadata.description) {\n    tags.push(`<meta name=\"description\" content=\"${escapeHTML(metadata.description)}\">`);\n  }\n\n  if (metadata.keywords && metadata.keywords.length > 0) {\n    tags.push(`<meta name=\"keywords\" content=\"${escapeHTML(metadata.keywords.join(', '))}\">`);\n  }\n\n  if (metadata.openGraph) {\n    for (const [key, value] of Object.entries(metadata.openGraph)) {\n      if (value) {\n        tags.push(`<meta property=\"og:${key}\" content=\"${escapeHTML(String(value))}\">`);\n      }\n    }\n  }\n\n  if (metadata.twitter) {\n    for (const [key, value] of Object.entries(metadata.twitter)) {\n      if (value) {\n        tags.push(`<meta name=\"twitter:${key}\" content=\"${escapeHTML(String(value))}\">`);\n      }\n    }\n  }\n\n  return tags.join('\\n');\n}\n"]}

package/dist/index.mjs

@@ -0,0 +1,116 @@
+import { escapeHTML } from '@lytjs/common-string';
+
+var __defProp = Object.defineProperty;
+var __defNormalProp = (obj, key, value) => key in obj ? __defProp(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
+var __publicField = (obj, key, value) => __defNormalProp(obj, key + "" , value);
+
+// src/builder.ts
+var MetadataBuilder = class {
+  constructor() {
+    /** 元数据对象 */
+    __publicField(this, "metadata", {});
+  }
+  /**
+   * 设置标题
+   *
+   * @param title - 标题
+   * @returns 构建器实例
+   */
+  title(title) {
+    this.metadata.title = title;
+    return this;
+  }
+  /**
+   * 设置描述
+   *
+   * @param description - 描述
+   * @returns 构建器实例
+   */
+  description(description) {
+    this.metadata.description = description;
+    return this;
+  }
+  /**
+   * 设置关键词
+   *
+   * @param keywords - 关键词数组
+   * @returns 构建器实例
+   */
+  keywords(keywords) {
+    this.metadata.keywords = keywords;
+    return this;
+  }
+  /**
+   * 设置 Open Graph 元数据
+   *
+   * @param og - Open Graph 元数据
+   * @returns 构建器实例
+   */
+  openGraph(og) {
+    this.metadata.openGraph = { ...this.metadata.openGraph, ...og };
+    return this;
+  }
+  /**
+   * 设置 Twitter 元数据
+   *
+   * @param twitter - Twitter 元数据
+   * @returns 构建器实例
+   */
+  twitter(twitter) {
+    this.metadata.twitter = { ...this.metadata.twitter, ...twitter };
+    return this;
+  }
+  /**
+   * 设置自定义属性
+   *
+   * @param key - 键
+   * @param value - 值
+   * @returns 构建器实例
+   */
+  set(key, value) {
+    this.metadata[key] = value;
+    return this;
+  }
+  /**
+   * 构建元数据
+   *
+   * @returns 元数据对象
+   */
+  build() {
+    return { ...this.metadata };
+  }
+};
+function createMetadataBuilder() {
+  return new MetadataBuilder();
+}
+function renderMetadata(metadata) {
+  const tags = [];
+  if (metadata.title) {
+    tags.push(`<title>${escapeHTML(metadata.title)}</title>`);
+  }
+  if (metadata.description) {
+    tags.push(`<meta name="description" content="${escapeHTML(metadata.description)}">`);
+  }
+  if (metadata.keywords && metadata.keywords.length > 0) {
+    tags.push(`<meta name="keywords" content="${escapeHTML(metadata.keywords.join(", "))}">`);
+  }
+  if (metadata.openGraph) {
+    for (const [key, value] of Object.entries(metadata.openGraph)) {
+      if (value) {
+        tags.push(`<meta property="og:${key}" content="${escapeHTML(String(value))}">`);
+      }
+    }
+  }
+  if (metadata.twitter) {
+    for (const [key, value] of Object.entries(metadata.twitter)) {
+      if (value) {
+        tags.push(`<meta name="twitter:${key}" content="${escapeHTML(String(value))}">`);
+      }
+    }
+  }
+  return tags.join("\n");
+}
+
+export { MetadataBuilder, createMetadataBuilder, renderMetadata };
+//# sourceMappingURL=index.mjs.map
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/builder.ts","../src/renderer.ts"],"names":[],"mappings":"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","file":"index.mjs","sourcesContent":["/**\n * 元数据构建器\n */\nimport type { Metadata, OpenGraphMetadata, TwitterMetadata } from '@lytjs/shared-types';\n\n/**\n * 元数据构建器类\n */\nexport class MetadataBuilder {\n  /** 元数据对象 */\n  private metadata: Metadata = {};\n\n  /**\n   * 设置标题\n   *\n   * @param title - 标题\n   * @returns 构建器实例\n   */\n  title(title: string): this {\n    this.metadata.title = title;\n    return this;\n  }\n\n  /**\n   * 设置描述\n   *\n   * @param description - 描述\n   * @returns 构建器实例\n   */\n  description(description: string): this {\n    this.metadata.description = description;\n    return this;\n  }\n\n  /**\n   * 设置关键词\n   *\n   * @param keywords - 关键词数组\n   * @returns 构建器实例\n   */\n  keywords(keywords: string[]): this {\n    this.metadata.keywords = keywords;\n    return this;\n  }\n\n  /**\n   * 设置 Open Graph 元数据\n   *\n   * @param og - Open Graph 元数据\n   * @returns 构建器实例\n   */\n  openGraph(og: OpenGraphMetadata): this {\n    this.metadata.openGraph = { ...this.metadata.openGraph, ...og };\n    return this;\n  }\n\n  /**\n   * 设置 Twitter 元数据\n   *\n   * @param twitter - Twitter 元数据\n   * @returns 构建器实例\n   */\n  twitter(twitter: TwitterMetadata): this {\n    this.metadata.twitter = { ...this.metadata.twitter, ...twitter };\n    return this;\n  }\n\n  /**\n   * 设置自定义属性\n   *\n   * @param key - 键\n   * @param value - 值\n   * @returns 构建器实例\n   */\n  set(key: string, value: unknown): this {\n    this.metadata[key] = value;\n    return this;\n  }\n\n  /**\n   * 构建元数据\n   *\n   * @returns 元数据对象\n   */\n  build(): Metadata {\n    return { ...this.metadata };\n  }\n}\n\n/**\n * 创建元数据构建器\n *\n * @returns 构建器实例\n */\nexport function createMetadataBuilder(): MetadataBuilder {\n  return new MetadataBuilder();\n}\n","/**\n * 元数据渲染器\n */\nimport type { Metadata } from '@lytjs/shared-types';\nimport { escapeHTML } from '@lytjs/common-string';\n\n/**\n * 渲染元数据为 HTML 标签\n *\n * @param metadata - 元数据对象\n * @returns HTML 标签字符串\n */\nexport function renderMetadata(metadata: Metadata): string {\n  const tags: string[] = [];\n\n  if (metadata.title) {\n    tags.push(`<title>${escapeHTML(metadata.title)}</title>`);\n  }\n\n  if (metadata.description) {\n    tags.push(`<meta name=\"description\" content=\"${escapeHTML(metadata.description)}\">`);\n  }\n\n  if (metadata.keywords && metadata.keywords.length > 0) {\n    tags.push(`<meta name=\"keywords\" content=\"${escapeHTML(metadata.keywords.join(', '))}\">`);\n  }\n\n  if (metadata.openGraph) {\n    for (const [key, value] of Object.entries(metadata.openGraph)) {\n      if (value) {\n        tags.push(`<meta property=\"og:${key}\" content=\"${escapeHTML(String(value))}\">`);\n      }\n    }\n  }\n\n  if (metadata.twitter) {\n    for (const [key, value] of Object.entries(metadata.twitter)) {\n      if (value) {\n        tags.push(`<meta name=\"twitter:${key}\" content=\"${escapeHTML(String(value))}\">`);\n      }\n    }\n  }\n\n  return tags.join('\\n');\n}\n"]}

package/package.json

@@ -0,0 +1,61 @@
+{
+  "name": "@lytjs/metadata",
+  "version": "6.6.0",
+  "description": "LytJS 元数据系统",
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.mjs",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.mjs",
+      "require": "./dist/index.cjs"
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "sideEffects": false,
+  "scripts": {
+    "dev": "tsup --watch",
+    "build": "tsup",
+    "test": "vitest run",
+    "test:watch": "test:watch",
+    "test:coverage": "vitest run --coverage",
+    "type-check": "tsc --noEmit",
+    "lint": "eslint \"src/**/*.ts\" \"tests/**/*.ts\"",
+    "clean": "rm -rf dist node_modules .turbo"
+  },
+  "dependencies": {
+    "@lytjs/common-is": "workspace:*",
+    "@lytjs/common-string": "workspace:*",
+    "@lytjs/shared-types": "workspace:*"
+  },
+  "devDependencies": {
+    "tsup": "^8.3.6",
+    "typescript": "^5.7.3",
+    "vitest": "^3.0.0"
+  },
+  "peerDependencies": {},
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://gitee.com/lytjs/lytjs.git",
+    "directory": "packages/ecosystem/packages/web-framework/packages/metadata"
+  },
+  "keywords": [
+    "lytjs",
+    "metadata",
+    "meta",
+    "seo"
+  ],
+  "author": "LytJS Team",
+  "license": "MIT"
+}