schema-dsl 1.2.4 → 2.0.0

package/dist/plugins/custom-validator.cjs

@@ -0,0 +1,146 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/plugins/custom-validator.ts
+var custom_validator_exports = {};
+__export(custom_validator_exports, {
+  customValidatorPlugin: () => customValidatorPlugin,
+  default: () => custom_validator_default
+});
+module.exports = __toCommonJS(custom_validator_exports);
+function getValidator(core) {
+  const coreRecord = core;
+  const validator = coreRecord.getDefaultValidator?.();
+  if (!validator) {
+    throw new Error("getDefaultValidator() is not available. Please provide schema-dsl core object.");
+  }
+  return validator;
+}
+function getPluginBucket() {
+  const globalRecord = globalThis;
+  if (!globalRecord.__schemaDsl_plugins) {
+    globalRecord.__schemaDsl_plugins = {};
+  }
+  return globalRecord.__schemaDsl_plugins;
+}
+var customValidatorPlugin = {
+  name: "custom-validator",
+  version: "1.0.0",
+  description: "Custom validator plugin \u2014 adds business-specific validation rules",
+  install(core, _options = {}, _context) {
+    const validator = getValidator(core);
+    this.addCustomKeywords(validator);
+    getPluginBucket()["custom-validator"] = this;
+    console.log("[Plugin] custom-validator installed");
+  },
+  uninstall() {
+    delete getPluginBucket()["custom-validator"];
+    console.log("[Plugin] custom-validator uninstalled");
+  },
+  addCustomKeywords(validator) {
+    const ajv = validator.getAjv();
+    if (!ajv.getKeyword?.("unique")) {
+      validator.addKeyword("unique", {
+        async: true,
+        type: "string",
+        validate: async function validateUnique(schema) {
+          if (!schema) return true;
+          const { table, field } = schema;
+          const exists = false;
+          if (exists) {
+            ;
+            validateUnique.errors = [{
+              keyword: "unique",
+              message: `${field} already exists in ${table}`,
+              params: { table, field }
+            }];
+            return false;
+          }
+          return true;
+        }
+      });
+    }
+    if (!ajv.getKeyword?.("passwordStrength")) {
+      validator.addKeyword("passwordStrength", {
+        type: "string",
+        validate: function validatePasswordStrength(schema, data) {
+          if (!schema) return true;
+          const strength = String(schema);
+          const value = String(data ?? "");
+          const rules = {
+            weak: /^.{6,}$/,
+            medium: /^(?=.*[a-z])(?=.*[A-Z]).{8,}$/,
+            strong: /^(?=.*[a-z])(?=.*[A-Z])(?=.*\d).{10,}$/
+          };
+          const pattern = rules[strength];
+          if (!pattern) return true;
+          if (!pattern.test(value)) {
+            ;
+            validatePasswordStrength.errors = [{
+              keyword: "passwordStrength",
+              message: `Password does not meet ${strength} strength requirements`,
+              params: { strength }
+            }];
+            return false;
+          }
+          return true;
+        }
+      });
+    }
+    if (!ajv.getKeyword?.("idCard")) {
+      validator.addKeyword("idCard", {
+        type: "string",
+        validate: (schema, data) => {
+          if (!schema) return true;
+          const value = String(data ?? "");
+          const pattern = /^[1-9]\d{5}(19|20)\d{2}(0[1-9]|1[0-2])(0[1-9]|[12]\d|3[01])\d{3}[\dXx]$/;
+          if (!pattern.test(value)) {
+            return false;
+          }
+          return customValidatorPlugin._validateIdCardChecksum(value);
+        }
+      });
+    }
+  },
+  _validateIdCardChecksum(idCard) {
+    const weights = [7, 9, 10, 5, 8, 4, 2, 1, 6, 3, 7, 9, 10, 5, 8, 4, 2];
+    const checksums = ["1", "0", "X", "9", "8", "7", "6", "5", "4", "3", "2"];
+    let sum = 0;
+    for (let i = 0; i < 17; i += 1) {
+      sum += Number.parseInt(idCard[i], 10) * weights[i];
+    }
+    const checksum = checksums[sum % 11];
+    return idCard[17].toUpperCase() === checksum;
+  },
+  hooks: {
+    onBeforeValidate() {
+    },
+    onAfterValidate() {
+    },
+    onError(error) {
+      console.error("[custom-validator] Error:", error.message);
+    }
+  }
+};
+var custom_validator_default = customValidatorPlugin;
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  customValidatorPlugin
+});
+//# sourceMappingURL=custom-validator.cjs.map

package/dist/plugins/custom-validator.d.cts

@@ -0,0 +1,10 @@
+import { P as Plugin } from '../plugin-CIKtTMtS.cjs';
+import { V as Validator } from '../Validator-C7GsVQOH.cjs';
+import 'ajv';
+
+declare const customValidatorPlugin: Plugin & {
+    addCustomKeywords: (validator: Validator) => void;
+    _validateIdCardChecksum: (idCard: string) => boolean;
+};
+
+export { customValidatorPlugin, customValidatorPlugin as default };

package/dist/plugins/custom-validator.d.ts

@@ -0,0 +1,10 @@
+import { P as Plugin } from '../plugin-CIKtTMtS.js';
+import { V as Validator } from '../Validator-hFWKGxir.js';
+import 'ajv';
+
+declare const customValidatorPlugin: Plugin & {
+    addCustomKeywords: (validator: Validator) => void;
+    _validateIdCardChecksum: (idCard: string) => boolean;
+};
+
+export { customValidatorPlugin, customValidatorPlugin as default };

package/dist/plugins/custom-validator.js

@@ -0,0 +1,121 @@
+// src/plugins/custom-validator.ts
+function getValidator(core) {
+  const coreRecord = core;
+  const validator = coreRecord.getDefaultValidator?.();
+  if (!validator) {
+    throw new Error("getDefaultValidator() is not available. Please provide schema-dsl core object.");
+  }
+  return validator;
+}
+function getPluginBucket() {
+  const globalRecord = globalThis;
+  if (!globalRecord.__schemaDsl_plugins) {
+    globalRecord.__schemaDsl_plugins = {};
+  }
+  return globalRecord.__schemaDsl_plugins;
+}
+var customValidatorPlugin = {
+  name: "custom-validator",
+  version: "1.0.0",
+  description: "Custom validator plugin \u2014 adds business-specific validation rules",
+  install(core, _options = {}, _context) {
+    const validator = getValidator(core);
+    this.addCustomKeywords(validator);
+    getPluginBucket()["custom-validator"] = this;
+    console.log("[Plugin] custom-validator installed");
+  },
+  uninstall() {
+    delete getPluginBucket()["custom-validator"];
+    console.log("[Plugin] custom-validator uninstalled");
+  },
+  addCustomKeywords(validator) {
+    const ajv = validator.getAjv();
+    if (!ajv.getKeyword?.("unique")) {
+      validator.addKeyword("unique", {
+        async: true,
+        type: "string",
+        validate: async function validateUnique(schema) {
+          if (!schema) return true;
+          const { table, field } = schema;
+          const exists = false;
+          if (exists) {
+            ;
+            validateUnique.errors = [{
+              keyword: "unique",
+              message: `${field} already exists in ${table}`,
+              params: { table, field }
+            }];
+            return false;
+          }
+          return true;
+        }
+      });
+    }
+    if (!ajv.getKeyword?.("passwordStrength")) {
+      validator.addKeyword("passwordStrength", {
+        type: "string",
+        validate: function validatePasswordStrength(schema, data) {
+          if (!schema) return true;
+          const strength = String(schema);
+          const value = String(data ?? "");
+          const rules = {
+            weak: /^.{6,}$/,
+            medium: /^(?=.*[a-z])(?=.*[A-Z]).{8,}$/,
+            strong: /^(?=.*[a-z])(?=.*[A-Z])(?=.*\d).{10,}$/
+          };
+          const pattern = rules[strength];
+          if (!pattern) return true;
+          if (!pattern.test(value)) {
+            ;
+            validatePasswordStrength.errors = [{
+              keyword: "passwordStrength",
+              message: `Password does not meet ${strength} strength requirements`,
+              params: { strength }
+            }];
+            return false;
+          }
+          return true;
+        }
+      });
+    }
+    if (!ajv.getKeyword?.("idCard")) {
+      validator.addKeyword("idCard", {
+        type: "string",
+        validate: (schema, data) => {
+          if (!schema) return true;
+          const value = String(data ?? "");
+          const pattern = /^[1-9]\d{5}(19|20)\d{2}(0[1-9]|1[0-2])(0[1-9]|[12]\d|3[01])\d{3}[\dXx]$/;
+          if (!pattern.test(value)) {
+            return false;
+          }
+          return customValidatorPlugin._validateIdCardChecksum(value);
+        }
+      });
+    }
+  },
+  _validateIdCardChecksum(idCard) {
+    const weights = [7, 9, 10, 5, 8, 4, 2, 1, 6, 3, 7, 9, 10, 5, 8, 4, 2];
+    const checksums = ["1", "0", "X", "9", "8", "7", "6", "5", "4", "3", "2"];
+    let sum = 0;
+    for (let i = 0; i < 17; i += 1) {
+      sum += Number.parseInt(idCard[i], 10) * weights[i];
+    }
+    const checksum = checksums[sum % 11];
+    return idCard[17].toUpperCase() === checksum;
+  },
+  hooks: {
+    onBeforeValidate() {
+    },
+    onAfterValidate() {
+    },
+    onError(error) {
+      console.error("[custom-validator] Error:", error.message);
+    }
+  }
+};
+var custom_validator_default = customValidatorPlugin;
+export {
+  customValidatorPlugin,
+  custom_validator_default as default
+};
+//# sourceMappingURL=custom-validator.js.map

package/docs/FEATURE-INDEX.md

@@ -1,7 +1,7 @@
 # schema-dsl 功能索引
 
 
-> **更新时间**: 2025-12-25  
+> **更新时间**: 2026-04-30  
 > **用途**: 快速查找所有功能及其文档位置  
 
 ---
@@ -43,7 +43,7 @@ const schema = dsl({
 - 📖 [快速开始](./quick-start.md)
 - 📖 [DSL语法指南](./dsl-syntax.md)
 
-**代码位置**: `lib/adapters/DslAdapter.js`
+**代码位置**: `src/index.ts` / `src/adapters/DslAdapter.ts`
 
 ---
 
@@ -59,7 +59,8 @@ const schema = dsl({
 - ✅ `custom(fn)` - 自定义验证器
 - ✅ `when(field, opts)` - 条件验证
 - ✅ `default(value)` - 默认值
-- ✅ `toSchema()` - 转为JSON Schema
+- ✅ `toSchema()` - 转为JSON Schema（含内部标记字段）
+- ✅ `toJsonSchema()` - 转为纯净 JSON Schema（自动清理 `_required`/`_customMessages` 等内部标记，适用于 OpenAPI / 外部系统）🆕 v1.2.5
 - ✅ `validate(data)` - 验证数据
 - ✅ `validateNestingDepth(schema, maxDepth)` - 检测嵌套深度（静态方法）
 
@@ -88,7 +89,7 @@ const userSchema = dsl({
 - 📖 [API参考 - DslBuilder类](./api-reference.md#dslbuilder-类)
 - 📖 [String扩展文档](./string-extensions.md)
 
-**代码位置**: `lib/core/DslBuilder.js`
+**代码位置**: `src/core/DslBuilder.ts`
 
 ---
 
@@ -108,10 +109,10 @@ const schema = dsl({
 
 **文档位置**:
 - 📖 [String扩展完整文档](./string-extensions.md)
-- 📖 [README](../README.md)
+- 📖 [README](https://github.com/vextjs/schema-dsl/blob/main/README.md)
 
 
-**代码位置**: `lib/core/StringExtensions.js`
+**代码位置**: `src/core/StringExtensions.ts`
 
 ---
 
@@ -124,7 +125,7 @@ const schema = dsl({
 **可用方法**:
 - ✅ `validate(schema, data, options)` - 验证数据
 - ✅ `compile(schema, cacheKey)` - 编译Schema
-- ✅ `validateBatch(schema, dataArray, options)` - 批量验证
+- ✅ `validateBatch(schema, dataArray)` - 批量验证
 - ✅ `addKeyword(name, definition)` - 添加自定义关键字
 - ✅ `addFormat(name, validator)` - 添加自定义格式
 - ✅ `clearCache()` - 清空缓存
@@ -147,7 +148,7 @@ console.log(result.errors);  // 错误列表
 - 📖 [validate方法详解](./validate.md)
 - 📖 [快速开始](./quick-start.md)
 
-**代码位置**: `lib/core/Validator.js`
+**代码位置**: `src/core/Validator.ts`
 
 ---
 
@@ -167,7 +168,7 @@ const result = validate(schema, { email: 'test@example.com' });
 - 📖 [API参考 - validate()函数](./api-reference.md)
 - 📖 [快速开始](./quick-start.md#1-hello-world30秒)
 
-**代码位置**: `index.js` (单例实现)
+**代码位置**: `src/index.ts`（默认单例导出）
 
 ---
 
@@ -196,10 +197,10 @@ console.log(command);
 ```
 
 **文档位置**:
-- 📖 [README - 数据库导出](../README.md#️-数据库导出)
-- 📖 [示例代码](../examples/export-demo.js)
+- 📖 [数据库导出指南](./export-guide.md)
+- 📖 [示例代码](https://github.com/vextjs/schema-dsl/blob/main/examples/docs/feature-index.ts)
 
-**代码位置**: `lib/exporters/MongoDBExporter.js`
+**代码位置**: `src/exporters/MongoDBExporter.ts`
 
 ---
 
@@ -226,10 +227,10 @@ console.log(ddl);
 ```
 
 **文档位置**:
-- 📖 [README - 数据库导出](../README.md#mysql-ddl)
-- 📖 [示例代码](../examples/export-demo.js)
+- 📖 [数据库导出指南](./export-guide.md)
+- 📖 [示例代码](https://github.com/vextjs/schema-dsl/blob/main/examples/docs/feature-index.ts)
 
-**代码位置**: `lib/exporters/MySQLExporter.js`
+**代码位置**: `src/exporters/MySQLExporter.ts`
 
 ---
 
@@ -256,10 +257,10 @@ console.log(ddl);
 ```
 
 **文档位置**:
-- 📖 [README - 数据库导出](../README.md#postgresql-ddl)
-- 📖 [示例代码](../examples/export-demo.js)
+- 📖 [数据库导出指南](./export-guide.md)
+- 📖 [示例代码](https://github.com/vextjs/schema-dsl/blob/main/examples/docs/feature-index.ts)
 
-**代码位置**: `lib/exporters/PostgreSQLExporter.js`
+**代码位置**: `src/exporters/PostgreSQLExporter.ts`
 
 ---
 
@@ -272,10 +273,12 @@ console.log(ddl);
 **可用方法**:
 - ✅ `reusable(factory)` - 创建可复用片段
 - ✅ `createLibrary(fragments)` - 创建片段库
-- ✅ `merge(...schemas)` - 合并多个Schema
 - ✅ `extend(baseSchema, extensions)` - 扩展Schema
 - ✅ `pick(schema, fields)` - 筛选字段
 - ✅ `omit(schema, fields)` - 排除字段
+- ✅ `partial(schema, fields?)` - 将字段改为可选
+- ✅ `validateBatch(schema, dataArray, ajvInstance)` - 带汇总统计的批量验证
+- ✅ `withPerformance(validator)` - 为 Validator 包装性能信息
 - ✅ `toMarkdown(schema)` - 导出为Markdown
 - ✅ `toHTML(schema)` - 导出为HTML
 - ✅ `clone(schema)` - 深度克隆
@@ -297,7 +300,7 @@ const extended = SchemaUtils.extend(schema1, { age: 'number' });
 **文档位置**:
 - 📖 [API参考 - SchemaUtils](./api-reference.md#工具函数)
 
-**代码位置**: `lib/utils/SchemaUtils.js`
+**代码位置**: `src/utils/SchemaUtils.ts`
 
 ---
 
@@ -306,15 +309,17 @@ const extended = SchemaUtils.extend(schema1, { age: 'number' });
 **功能**: 类型转换工具（JSON Schema ↔ 数据库类型）
 
 **可用方法**:
-- ✅ `toMongoType(jsonSchemaType)` - 转为MongoDB BSON类型
-- ✅ `toMySQLType(jsonSchemaProperty)` - 转为MySQL数据类型
-- ✅ `toPostgreSQLType(jsonSchemaProperty)` - 转为PostgreSQL数据类型
+- ✅ `toJSONSchemaType(nativeType)` - 转为 JSON Schema `type` 字符串
+- ✅ `toMongoDBType(jsonSchemaType)` - 转为 MongoDB BSON 类型
+- ✅ `toMySQLType(jsonSchemaType, schema?)` - 转为 MySQL 数据类型
+- ✅ `toPostgreSQLType(jsonSchemaType, schema?)` - 转为 PostgreSQL 数据类型
+- ✅ `normalizePropertyName(name)` - 规范化属性名
 - ✅ `formatToRegex(format)` - 格式验证转正则
 
 **文档位置**:
-- 📖 [API参考 - TypeConverter](./api-reference.md#typeconverter)
+- 📖 [TypeConverter 文档](./type-converter.md)
 
-**代码位置**: `lib/utils/TypeConverter.js`
+**代码位置**: `src/utils/TypeConverter.ts`
 
 ---
 
@@ -323,16 +328,22 @@ const extended = SchemaUtils.extend(schema1, { age: 'number' });
 **功能**: Schema分析和辅助工具
 
 **可用方法**:
-- ✅ `validate(schema)` - 验证Schema有效性
+- ✅ `isValidSchema(schema)` - 验证 Schema 有效性
+- ✅ `generateSchemaId(schema)` - 生成基于内容的 Schema ID
 - ✅ `getFieldPaths(schema)` - 提取字段路径
-- ✅ `flatten(schema)` - 扁平化Schema
-- ✅ `clone(schema)` - 克隆Schema
-- ✅ `getComplexity(schema)` - 评估复杂度
+- ✅ `flattenSchema(schema)` - 扁平化 Schema
+- ✅ `cloneSchema(schema)` - 克隆 Schema
+- ✅ `extractRequiredFields(schema)` - 提取 required 字段
+- ✅ `compareSchemas(schema1, schema2)` - 比较 Schema
+- ✅ `simplifySchema(schema)` - 精简 Schema
+- ✅ `isValidPropertyName(name)` - 校验属性名
+- ✅ `getSchemaComplexity(schema)` - 评估复杂度
+- ✅ `summarizeSchema(schema)` - 生成摘要
 
 **文档位置**:
-- 📖 [API参考 - SchemaHelper](./api-reference.md#schemahelper)
+- 📖 [SchemaHelper 文档](./schema-helper.md)
 
-**代码位置**: `lib/utils/SchemaHelper.js`
+**代码位置**: `src/utils/SchemaHelper.ts`
 
 ---
 
@@ -343,16 +354,15 @@ const extended = SchemaUtils.extend(schema1, { age: 'number' });
 **功能**: 格式化验证错误信息
 
 **可用方法**:
-- ✅ `format(errors, options)` - 格式化错误列表
-- ✅ `formatSingle(error, options)` - 格式化单个错误
-- ✅ `toJSON(errors)` - 转为JSON格式
-- ✅ `toText(errors)` - 转为文本格式
+- ✅ `new ErrorFormatter(locale?, messages?)` - 创建格式化器
+- ✅ `format(error, locale?)` - 格式化单个错误为消息字符串
+- ✅ `formatDetailed(errors, locale?, customMessages?, alreadyMerged?)` - 格式化错误数组为标准错误项
 
 **文档位置**:
-- 📖 [API参考 - ErrorFormatter](./api-reference.md)
+- 📖 [API参考 - ErrorFormatter / MessageTemplate / 底层解析工具](./api-reference.md)
 - 📖 [错误处理文档](./error-handling.md)
 
-**代码位置**: `lib/core/ErrorFormatter.js`
+**代码位置**: `src/core/ErrorFormatter.ts`
 
 ---
 
@@ -360,7 +370,7 @@ const extended = SchemaUtils.extend(schema1, { age: 'number' });
 
 **功能**: 错误码定义
 
-**代码位置**: `lib/core/ErrorCodes.js`
+**代码位置**: `src/core/ErrorCodes.ts`
 
 ---
 
@@ -374,9 +384,25 @@ const extended = SchemaUtils.extend(schema1, { age: 'number' });
 - ✅ `MessageTemplate.renderBatch(templates, vars)` - 批量渲染（静态方法）
 
 **文档位置**:
-- 📖 [API参考 - MessageTemplate](./api-reference.md)
+- 📖 [API参考 - MessageTemplate](./api-reference.md#messagetemplate)
 
-**代码位置**: `lib/core/MessageTemplate.js`
+**代码位置**: `src/core/MessageTemplate.ts`
+
+---
+
+### 类型注册与模板工具
+
+**功能**: 面向进阶集成的模板渲染、JSON Schema 外观与自定义类型注册能力
+
+**可用导出**:
+- ✅ `renderTemplate(template, params)`
+- ✅ `JSONSchemaCore`
+- ✅ `TypeRegistry`
+
+**文档位置**:
+- 📖 [API参考 - renderTemplate / JSONSchemaCore / 类型注册与内部解析边界](./api-reference.md)
+
+**代码位置**: `src/core/TemplateEngine.ts` / `src/core/JSONSchemaCore.ts` / `src/parser/TypeRegistry.ts`
 
 ---
 
@@ -396,11 +422,14 @@ const extended = SchemaUtils.extend(schema1, { age: 'number' });
 **支持语言**:
 - ✅ en-US（英语）
 - ✅ zh-CN（中文）
+- ✅ ja-JP（日语）
+- ✅ es-ES（西班牙语）
+- ✅ fr-FR（法语）
 
 **文档位置**:
 - 📖 [API参考 - Locale](./api-reference.md)
 
-**代码位置**: `lib/core/Locale.js`
+**代码位置**: `src/core/Locale.ts`
 
 ---
 
@@ -419,9 +448,9 @@ const extended = SchemaUtils.extend(schema1, { age: 'number' });
 - ✅ `size()` - 缓存大小
 
 **文档位置**:
-- 📖 [API参考 - CacheManager](./api-reference.md)
+- 📖 [CacheManager 文档](./cache-manager.md)
 
-**代码位置**: `lib/core/CacheManager.js`
+**代码位置**: `src/core/CacheManager.ts`
 
 ---
 
@@ -431,8 +460,7 @@ const extended = SchemaUtils.extend(schema1, { age: 'number' });
 
 **可用关键字**:
 - ✅ `regex` - 正则验证
-- ✅ `validate` - 函数验证
-- ✅ `range` - 数值范围
+- ✅ `validate` - 自定义函数验证
 
 **使用示例**:
 ```javascript
@@ -448,9 +476,9 @@ const schema = {
 ```
 
 **文档位置**:
-- 📖 [README - 自定义验证](../README.md#-自定义验证)
+- 📖 [错误处理文档](./error-handling.md)
 
-**代码位置**: `lib/validators/CustomKeywords.js`
+**代码位置**: `src/validators/CustomKeywords.ts`
 
 ---
 
@@ -459,15 +487,15 @@ const schema = {
 ### 完整示例目录
 
 **基础示例**:
-- 📄 [dsl-style.js](../examples/dsl-style.js) - DSL基础用法
-- 📄 [string-extensions.js](../examples/string-extensions.js) - String扩展示例
+- 📄 [dsl-syntax.ts](https://github.com/vextjs/schema-dsl/blob/main/examples/docs/dsl-syntax.ts) - DSL基础用法
+- 📄 [string-extensions.ts](https://github.com/vextjs/schema-dsl/blob/main/examples/docs/string-extensions.ts) - String扩展示例
 
 **场景示例**:
-- 📁 [user-registration/](../examples/user-registration/) - 用户注册表单验证
-- 📁 [password-reset/](../examples/password-reset/) - 密码重置流程
+- 📄 [quick-start.ts](https://github.com/vextjs/schema-dsl/blob/main/examples/docs/quick-start.ts) - 用户注册式的基础表单验证起点
+- 📄 [validation-guide.ts](https://github.com/vextjs/schema-dsl/blob/main/examples/docs/validation-guide.ts) - 失败路径、错误处理与规则组合示例
 
 **导出示例**:
-- 📄 [export-demo.js](../examples/export-demo.js) - 数据库导出示例
+- 📄 [feature-index.ts](https://github.com/vextjs/schema-dsl/blob/main/examples/docs/feature-index.ts) - 功能索引代表性示例
 
 ---
 
@@ -480,40 +508,46 @@ const schema = {
 3. ✅ Validator类 - `docs/validate.md`
 4. ✅ API参考 - `docs/api-reference.md`
 5. ✅ 快速开始 - `docs/quick-start.md`
-6. ✅ 数据库导出 - `README.md` + `examples/export-demo.js`
+6. ✅ 数据库导出 - `README.md` + `docs/export-guide.md`
 7. ✅ 自定义验证 - `README.md`
-8. ✅ Schema工具 - `examples/schema-utils-chaining.examples.js`
+8. ✅ Schema工具 - `docs/schema-utils.md` + `docs/schema-helper.md`
 
 ### ⚠️ 文档需要补充
 
-1. ⚠️ ErrorFormatter - 缺少独立文档
-2. ⚠️ CacheManager - 缺少独立文档
-3. ⚠️ TypeConverter - 缺少独立文档
-4. ⚠️ SchemaHelper - 缺少独立文档
-5. ⚠️ 错误处理 - 需要完整文档
+1. ⚠️ ErrorFormatter - 当前已在 API 参考与错误处理文档中覆盖；如需更聚焦入口，可后续增补专项文档
+2. ⚠️ PluginManager - 可补一份更聚焦的 API/Hook 速查
+3. ⚠️ 性能与基准测试 - 可继续补充独立诊断手册
+4. ⚠️ 示例运行方式 - 可补充统一的 TypeScript 示例编译说明
+5. ⚠️ 错误处理 - 可继续补充更完整的框架集成案例
 
 ### 📝 计划补充
 
-- [ ] 创建 `docs/error-handling.md` - 错误处理完整指南
-- [ ] 创建 `docs/utilities.md` - 工具函数完整文档
-- [ ] 创建 `docs/advanced.md` - 高级用法指南
-- [ ] 创建 `docs/performance.md` - 性能优化指南
+- [ ] 增补 `ErrorFormatter` 专项文档
+- [ ] 增补 Plugin Hook 速查文档
+- [ ] 增补 TypeScript 示例统一运行说明
+- [ ] 增补性能调优/基准解读手册
 
 ---
 
 ## 相关文档
 
-- 📖 [README.md](../README.md) - 项目介绍
+- 📖 [README.md](https://github.com/vextjs/schema-dsl/blob/main/README.md) - 项目介绍
 - 📖 [快速开始](./quick-start.md) - 5分钟入门
 - 📖 [DSL语法指南](./dsl-syntax.md) - 完整语法
 - 📖 [String扩展](./string-extensions.md) - String扩展特性
 - 📖 [API参考](./api-reference.md) - 完整API
-- 📖 [CHANGELOG](../CHANGELOG.md) - 更新日志
-- 📖 [STATUS](../STATUS.md) - 项目状态
+- 📖 [CHANGELOG](https://github.com/vextjs/schema-dsl/blob/main/CHANGELOG.md) - 更新日志
+
+---
+
+## 对应示例文件
+
+**示例入口**: [feature-index.ts](https://github.com/vextjs/schema-dsl/blob/main/examples/docs/feature-index.ts)  
+**说明**: 以单文件串联 DSL、String 扩展和导出器三个代表性能力，作为功能索引页的快速落地入口。
 
 ---
 
-**最后更新**: 2025-12-29
-**维护者**: SchemaI-DSL Team
+**最后更新**: 2026-05-08
+**维护者**: schema-dsl Team