@schemashift/core 0.8.0 → 0.9.0

package/README.md

@@ -282,6 +282,108 @@ if (info.detected) {
 
 Supports: Zod 3.23+, Valibot 1.0+, ArkType 2.0+, @effect/schema, TypeBox 0.34+.
 
+### BehavioralWarningAnalyzer
+
+Detects behavioral differences between schema libraries during migration.
+
+```typescript
+import { BehavioralWarningAnalyzer } from '@schemashift/core';
+
+const analyzer = new BehavioralWarningAnalyzer();
+const result = analyzer.analyze(sourceFiles, 'yup', 'zod');
+// result.warnings: grouped by category (coercion, validation-order, error-format)
+for (const w of result.warnings) {
+  console.log(`[${w.category}] ${w.message}`);
+}
+```
+
+**Tier:** FREE (all tiers)
+
+### BundleEstimator
+
+Estimates bundle size impact of switching schema libraries.
+
+```typescript
+import { BundleEstimator } from '@schemashift/core';
+
+const estimator = new BundleEstimator();
+const estimate = estimator.estimate(sourceFiles, 'zod', 'valibot');
+console.log(`From: ${estimate.from.minifiedGzipKB}kB → To: ${estimate.to.minifiedGzipKB}kB`);
+console.log(`Delta: ${estimate.estimatedDelta.toFixed(1)}kB (${estimate.deltaPercent.toFixed(0)}%)`);
+```
+
+**Tier:** INDIVIDUAL+
+
+### PerformanceAnalyzer
+
+Identifies potential performance impacts of migration.
+
+```typescript
+import { PerformanceAnalyzer } from '@schemashift/core';
+
+const analyzer = new PerformanceAnalyzer();
+const result = analyzer.analyze(sourceFiles, 'zod-v3', 'v4');
+for (const w of result.warnings) {
+  console.log(`[${w.severity}] ${w.message}: ${w.detail}`);
+}
+```
+
+**Tier:** INDIVIDUAL+
+
+### TypeDedupDetector
+
+Finds structurally similar schema definitions across files.
+
+```typescript
+import { TypeDedupDetector } from '@schemashift/core';
+
+const detector = new TypeDedupDetector();
+const result = detector.detect(sourceFiles);
+for (const candidate of result.candidates) {
+  console.log(`Duplicate: ${candidate.schemas.map(s => s.name).join(', ')} (${candidate.confidence}% confidence)`);
+}
+```
+
+**Tier:** INDIVIDUAL+
+
+### TestScaffolder
+
+Generates validation test stubs for migrated schemas.
+
+```typescript
+import { TestScaffolder } from '@schemashift/core';
+
+const scaffolder = new TestScaffolder();
+const result = scaffolder.scaffold(sourceFiles, 'yup', 'zod');
+console.log(`Generated ${result.tests.length} test files for ${result.totalSchemas} schemas`);
+for (const test of result.tests) {
+  console.log(`  ${test.filePath} (${test.schemaCount} schemas)`);
+}
+```
+
+**Tier:** PRO+
+
+### MigrationAuditLog
+
+Records detailed migration history for compliance and auditing.
+
+```typescript
+import { MigrationAuditLog } from '@schemashift/core';
+
+const auditLog = new MigrationAuditLog('./project');
+const entry = auditLog.createEntry({
+  file: 'src/schema.ts',
+  from: 'yup',
+  to: 'zod',
+  success: true,
+  warningsCount: 2,
+});
+auditLog.append(entry);
+// Writes to .schemashift/audit-log.json
+```
+
+**Tier:** TEAM
+
 ### detectSchemaLibrary
 
 Detects which schema library a module import refers to.