@schemashift/zod-superstruct 0.10.0

package/README.md

@@ -0,0 +1,114 @@
+# @schemashift/zod-superstruct
+
+Zod ↔ Superstruct transformer for SchemaShift. Supports both forward (Zod → Superstruct) and backward (Superstruct → Zod) migrations.
+
+**Tier:** Pro+
+
+## Installation
+
+```bash
+npm install @schemashift/zod-superstruct
+```
+
+## Usage
+
+```typescript
+import { createZodToSuperstructHandler, createSuperstructToZodHandler } from '@schemashift/zod-superstruct';
+import { TransformEngine } from '@schemashift/core';
+
+const engine = new TransformEngine();
+engine.registerHandler('zod', 'superstruct', createZodToSuperstructHandler());
+engine.registerHandler('superstruct', 'zod', createSuperstructToZodHandler()); // Backward migration (Pro+)
+```
+
+## API Paradigm Difference
+
+Zod uses a **namespaced chain** API:
+
+```typescript
+z.object({ name: z.string().email(), age: z.number().int() })
+```
+
+Superstruct uses **bare function** imports:
+
+```typescript
+object({ name: refine(string(), "email", ...), age: integer() })
+```
+
+## Transformation Mappings
+
+### Imports
+
+| Zod | Superstruct |
+|-----|-------------|
+| `import { z } from 'zod'` | `import { object, string, ... } from 'superstruct'` |
+
+### Factory Methods
+
+| Zod | Superstruct |
+|-----|-------------|
+| `z.string()` | `string()` |
+| `z.number()` | `number()` |
+| `z.boolean()` | `boolean()` |
+| `z.date()` | `date()` |
+| `z.bigint()` | `bigint()` |
+| `z.any()` | `any()` |
+| `z.unknown()` | `unknown()` |
+| `z.never()` | `never()` |
+| `z.object({...})` | `object({...})` |
+| `z.array(s)` | `array(s)` |
+| `z.enum(["a", "b"])` | `enums(["a", "b"])` |
+| `z.literal(42)` | `literal(42)` |
+| `z.union([a, b])` | `union([a, b])` |
+| `z.record(k, v)` | `record(k, v)` |
+| `z.tuple([a, b])` | `tuple([a, b])` |
+| `z.number().int()` | `integer()` |
+
+### Modifiers
+
+| Zod | Superstruct |
+|-----|-------------|
+| `.optional()` | `optional(X)` |
+| `.nullable()` | `nullable(X)` |
+
+### Type Helpers
+
+| Zod | Superstruct |
+|-----|-------------|
+| `z.infer<typeof s>` | `Infer<typeof s>` |
+
+## Patterns Requiring Manual Review
+
+### `.discriminatedUnion()`
+
+Superstruct has no discriminatedUnion. Use `union()` with explicit struct variants.
+
+### `.transform()` / `.preprocess()`
+
+Superstruct uses `coerce()` for transforms:
+
+```typescript
+// Zod
+z.string().transform((s) => s.toUpperCase());
+
+// Superstruct
+coerce(string(), string(), (s) => s.toUpperCase());
+```
+
+### `define()` (Custom Validators)
+
+```typescript
+// Superstruct
+const Email = define('email', (v) => typeof v === 'string' && v.includes('@'));
+
+// Zod
+const Email = z.string().refine((v) => v.includes('@'));
+```
+
+### `.brand()`
+
+Superstruct has no `.brand()` equivalent. Use `define()` with a branded type.
+
+## License
+
+MIT

package/dist/index.cjs

@@ -0,0 +1,420 @@
+"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/index.ts
+var index_exports = {};
+__export(index_exports, {
+  IMPORT_MAPPINGS: () => IMPORT_MAPPINGS,
+  MANUAL_REVIEW_PATTERNS: () => MANUAL_REVIEW_PATTERNS,
+  SUPERSTRUCT_REFINEMENT_TO_ZOD: () => SUPERSTRUCT_REFINEMENT_TO_ZOD,
+  SUPERSTRUCT_TO_ZOD_FACTORIES: () => SUPERSTRUCT_TO_ZOD_FACTORIES,
+  ZOD_TO_SUPERSTRUCT_FACTORIES: () => ZOD_TO_SUPERSTRUCT_FACTORIES,
+  ZOD_VALIDATION_TO_SUPERSTRUCT: () => ZOD_VALIDATION_TO_SUPERSTRUCT,
+  createSuperstructToZodHandler: () => createSuperstructToZodHandler,
+  createZodToSuperstructHandler: () => createZodToSuperstructHandler
+});
+module.exports = __toCommonJS(index_exports);
+
+// src/mappings.ts
+var ZOD_TO_SUPERSTRUCT_FACTORIES = {
+  "z.string()": "string()",
+  "z.number()": "number()",
+  "z.boolean()": "boolean()",
+  "z.date()": "date()",
+  "z.any()": "any()",
+  "z.unknown()": "unknown()",
+  "z.never()": "never()",
+  "z.bigint()": "bigint()",
+  "z.undefined()": "literal(undefined)",
+  "z.null()": "literal(null)",
+  "z.void()": "literal(undefined)",
+  "z.nan()": 'define("nan", (v) => Number.isNaN(v))'
+};
+var SUPERSTRUCT_TO_ZOD_FACTORIES = {
+  "string()": "z.string()",
+  "number()": "z.number()",
+  "boolean()": "z.boolean()",
+  "date()": "z.date()",
+  "any()": "z.any()",
+  "unknown()": "z.unknown()",
+  "never()": "z.never()",
+  "bigint()": "z.bigint()",
+  "integer()": "z.number().int()",
+  "func()": "z.function()",
+  "instance(Date)": "z.date()",
+  "instance(RegExp)": "z.instanceof(RegExp)"
+};
+var ZOD_VALIDATION_TO_SUPERSTRUCT = {
+  email: "pattern(/^[^\\s@]+@[^\\s@]+\\.[^\\s@]+$/)",
+  url: "pattern(/^https?:\\/\\/.+/)",
+  uuid: "pattern(/^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i)",
+  ip: "pattern(/^(?:\\d{1,3}\\.){3}\\d{1,3}$/)",
+  int: 'refine("integer", (v) => Number.isInteger(v))'
+};
+var SUPERSTRUCT_REFINEMENT_TO_ZOD = {
+  "size(string(), 1, Infinity)": "z.string().min(1)",
+  "nonempty(string())": "z.string().min(1)",
+  "nonempty(array())": "z.array().min(1)"
+};
+var IMPORT_MAPPINGS = {
+  zodToSuperstruct: {
+    from: "zod",
+    to: "superstruct",
+    zodImport: "z",
+    superstructImports: [
+      "object",
+      "string",
+      "number",
+      "boolean",
+      "date",
+      "array",
+      "optional",
+      "nullable",
+      "union",
+      "literal",
+      "enums",
+      "record",
+      "tuple",
+      "any",
+      "unknown",
+      "never",
+      "define",
+      "refine",
+      "coerce",
+      "bigint",
+      "type",
+      "assign",
+      "size",
+      "pattern",
+      "integer"
+    ]
+  },
+  superstructToZod: {
+    from: "superstruct",
+    to: "zod",
+    zodImport: "z"
+  }
+};
+var MANUAL_REVIEW_PATTERNS = [
+  "discriminatedUnion",
+  "superRefine",
+  "transform",
+  "preprocess",
+  "lazy",
+  "brand",
+  "catch",
+  "pipe",
+  "define",
+  "coerce",
+  "mask",
+  "create",
+  "assert",
+  "is"
+];
+
+// src/superstruct-to-zod-transformer.ts
+var SuperstructToZodTransformer = class {
+  errors = [];
+  warnings = [];
+  transform(sourceFile) {
+    this.errors = [];
+    this.warnings = [];
+    const filePath = sourceFile.getFilePath();
+    const originalCode = sourceFile.getFullText();
+    try {
+      let text = originalCode;
+      text = this.rewriteImports(text, filePath);
+      text = this.transformStructs(text, filePath);
+      text = this.transformTypeHelpers(text);
+      sourceFile.replaceWithText(text);
+      return {
+        success: this.errors.length === 0,
+        filePath,
+        originalCode,
+        transformedCode: sourceFile.getFullText(),
+        errors: this.errors,
+        warnings: this.warnings
+      };
+    } catch (error) {
+      this.errors.push({
+        message: error instanceof Error ? error.message : "Unknown error"
+      });
+      return {
+        success: false,
+        filePath,
+        originalCode,
+        errors: this.errors,
+        warnings: this.warnings
+      };
+    }
+  }
+  rewriteImports(text, filePath) {
+    text = text.replace(
+      /import\s*\{[^}]+\}\s*from\s*['"]superstruct['"]/g,
+      "import { z } from 'zod'"
+    );
+    text = text.replace(
+      /import\s+type\s*\{[^}]+\}\s*from\s*['"]superstruct['"]/g,
+      "import type { z } from 'zod'"
+    );
+    if (text.includes("define(")) {
+      this.warnings.push(
+        `${filePath}: Superstruct define() should be converted to z.custom() or z.refine().`
+      );
+    }
+    if (text.includes("coerce(")) {
+      this.warnings.push(
+        `${filePath}: Superstruct coerce() should be converted to z.preprocess() or z.coerce.*.`
+      );
+    }
+    if (text.includes("mask(")) {
+      this.warnings.push(
+        `${filePath}: Superstruct mask() (strip unknown keys) maps to z.object().strip() in Zod.`
+      );
+    }
+    return text;
+  }
+  transformStructs(text, filePath) {
+    for (const [ssFactory, zodFactory] of Object.entries(SUPERSTRUCT_TO_ZOD_FACTORIES)) {
+      const fnName = ssFactory.match(/^(\w+)\(/)?.[1];
+      if (fnName) {
+        const pattern = new RegExp(`(?<!\\.)\\b${this.escapeRegex(ssFactory)}`, "g");
+        text = text.replace(pattern, zodFactory);
+      }
+    }
+    text = text.replace(/(?<!\.)(?<!\w)\bobject\(/g, "z.object(");
+    text = text.replace(/(?<!\.)(?<!\w)\barray\(/g, "z.array(");
+    text = text.replace(/\boptional\(z\.(\w+)\(\)\)/g, "z.$1().optional()");
+    text = text.replace(/\boptional\((z\.\w+\([^)]*\)(?:\.\w+\([^)]*\))*)\)/g, "$1.optional()");
+    text = text.replace(/\bnullable\(z\.(\w+)\(\)\)/g, "z.$1().nullable()");
+    text = text.replace(/\bnullable\((z\.\w+\([^)]*\)(?:\.\w+\([^)]*\))*)\)/g, "$1.nullable()");
+    text = text.replace(/(?<!\.)(?<!\w)\benums\(/g, "z.enum(");
+    text = text.replace(/(?<!\.)(?<!\w)\bliteral\(/g, "z.literal(");
+    text = text.replace(/(?<!\.)(?<!\w)\bunion\(/g, "z.union(");
+    text = text.replace(/(?<!\.)(?<!\w)\brecord\(/g, "z.record(");
+    text = text.replace(/(?<!\.)(?<!\w)\btuple\(/g, "z.tuple(");
+    text = text.replace(/(?<!\.)(?<!\w)\binteger\(\)/g, "z.number().int()");
+    text = text.replace(/\brefine\((z\.[^,]+),\s*"[^"]*",\s*([^)]+)\)/g, "$1.refine($2)");
+    text = text.replace(/\bsize\(z\.string\(\),\s*(\d+),\s*Infinity\)/g, "z.string().min($1)");
+    text = text.replace(/\bsize\(z\.string\(\),\s*0,\s*(\d+)\)/g, "z.string().max($1)");
+    text = text.replace(/\bsize\(z\.string\(\),\s*(\d+),\s*(\d+)\)/g, "z.string().min($1).max($2)");
+    text = text.replace(/\bpattern\(z\.string\(\),\s*([^)]+)\)/g, "z.string().regex($1)");
+    if (text.includes("assign(")) {
+      this.warnings.push(
+        `${filePath}: Superstruct assign() should be converted to .merge() or .extend() in Zod.`
+      );
+    }
+    if (/(?<!\.)(?<!\w)\btype\(/.test(text)) {
+      this.warnings.push(
+        `${filePath}: Superstruct type() (all-optional object) should be converted to z.object({}).partial() in Zod.`
+      );
+      text = text.replace(/(?<!\.)(?<!\w)\btype\(\{/g, "z.object({");
+    }
+    return text;
+  }
+  transformTypeHelpers(text) {
+    text = text.replace(/\bInfer<typeof\s+(\w+)>/g, "z.infer<typeof $1>");
+    return text;
+  }
+  escapeRegex(str) {
+    return str.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+  }
+};
+
+// src/superstruct-to-zod-handler.ts
+function createSuperstructToZodHandler() {
+  return {
+    transform(sourceFile, _options) {
+      const transformer = new SuperstructToZodTransformer();
+      return transformer.transform(sourceFile);
+    }
+  };
+}
+
+// src/zod-to-superstruct-transformer.ts
+var ZodToSuperstructTransformer = class {
+  errors = [];
+  warnings = [];
+  usedImports = /* @__PURE__ */ new Set();
+  transform(sourceFile) {
+    this.errors = [];
+    this.warnings = [];
+    this.usedImports = /* @__PURE__ */ new Set();
+    const filePath = sourceFile.getFilePath();
+    const originalCode = sourceFile.getFullText();
+    try {
+      let text = originalCode;
+      text = this.transformSchemas(text, filePath);
+      text = this.transformTypeHelpers(text);
+      text = this.rewriteImports(text);
+      this.checkManualReviewPatterns(text, filePath);
+      sourceFile.replaceWithText(text);
+      return {
+        success: this.errors.length === 0,
+        filePath,
+        originalCode,
+        transformedCode: sourceFile.getFullText(),
+        errors: this.errors,
+        warnings: this.warnings
+      };
+    } catch (error) {
+      this.errors.push({
+        message: error instanceof Error ? error.message : "Unknown error"
+      });
+      return {
+        success: false,
+        filePath,
+        originalCode,
+        errors: this.errors,
+        warnings: this.warnings
+      };
+    }
+  }
+  rewriteImports(text) {
+    const imports = [...this.usedImports].sort();
+    text = text.replace(
+      /import\s*\{[^}]*\bz\b[^}]*\}\s*from\s*['"]zod['"]/g,
+      `import { ${imports.join(", ")} } from 'superstruct'`
+    );
+    text = text.replace(
+      /import\s*\*\s*as\s*z\s*from\s*['"]zod['"]/g,
+      `import { ${imports.join(", ")} } from 'superstruct'`
+    );
+    text = text.replace(
+      /import\s+type\s*\{[^}]*\}\s*from\s*['"]zod['"]/g,
+      `import type { Infer } from 'superstruct'`
+    );
+    return text;
+  }
+  transformSchemas(text, filePath) {
+    for (const [zodFactory, ssFactory] of Object.entries(ZOD_TO_SUPERSTRUCT_FACTORIES)) {
+      if (text.includes(zodFactory)) {
+        text = text.replace(new RegExp(this.escapeRegex(zodFactory), "g"), ssFactory);
+        const fnName = ssFactory.match(/^(\w+)\(/)?.[1];
+        if (fnName) this.usedImports.add(fnName);
+      }
+    }
+    text = text.replace(/\bz\.object\(/g, "object(");
+    this.usedImports.add("object");
+    text = text.replace(/\bz\.array\(/g, "array(");
+    this.usedImports.add("array");
+    text = text.replace(/(\w+\([^)]*\))\.optional\(\)/g, "optional($1)");
+    this.usedImports.add("optional");
+    text = text.replace(/(\w+\([^)]*\))\.nullable\(\)/g, "nullable($1)");
+    this.usedImports.add("nullable");
+    text = text.replace(/\bz\.enum\(/g, "enums(");
+    this.usedImports.add("enums");
+    text = text.replace(/\bz\.literal\(/g, "literal(");
+    this.usedImports.add("literal");
+    text = text.replace(/\bz\.union\(/g, "union(");
+    this.usedImports.add("union");
+    text = text.replace(/\bz\.record\(/g, "record(");
+    this.usedImports.add("record");
+    text = text.replace(/\bz\.tuple\(/g, "tuple(");
+    this.usedImports.add("tuple");
+    for (const [zodMethod, ssReplacement] of Object.entries(ZOD_VALIDATION_TO_SUPERSTRUCT)) {
+      const pattern = new RegExp(`string\\(\\)\\.${zodMethod}\\(\\)`, "g");
+      if (pattern.test(text)) {
+        text = text.replace(
+          pattern,
+          `${ssReplacement.startsWith("pattern") ? ssReplacement.replace("pattern(", "pattern(string(), ") : ssReplacement.replace("refine(", "refine(string(), ")}`
+        );
+        const fnName = ssReplacement.match(/^(\w+)\(/)?.[1];
+        if (fnName) this.usedImports.add(fnName);
+        this.usedImports.add("string");
+      }
+    }
+    text = text.replace(/string\(\)\.min\((\d+)\)/g, (_m, n) => {
+      this.usedImports.add("size");
+      this.usedImports.add("string");
+      return `size(string(), ${n}, Infinity)`;
+    });
+    text = text.replace(/string\(\)\.max\((\d+)\)/g, (_m, n) => {
+      this.usedImports.add("size");
+      this.usedImports.add("string");
+      return `size(string(), 0, ${n})`;
+    });
+    text = text.replace(/number\(\)\.int\(\)/g, "integer()");
+    this.usedImports.add("integer");
+    text = text.replace(/(\w+\([^)]*\))\.refine\(([^)]+)\)/g, (_m, schema, fn) => {
+      this.usedImports.add("refine");
+      return `refine(${schema}, "custom", ${fn})`;
+    });
+    if (/\bz\./.test(text)) {
+      this.warnings.push(
+        `${filePath}: Some Zod patterns could not be auto-transformed to Superstruct. Look for remaining z.* references and convert manually.`
+      );
+    }
+    return text;
+  }
+  transformTypeHelpers(text) {
+    text = text.replace(/z\.infer<typeof\s+(\w+)>/g, "Infer<typeof $1>");
+    text = text.replace(/z\.input<typeof\s+(\w+)>/g, "Infer<typeof $1>");
+    text = text.replace(/z\.output<typeof\s+(\w+)>/g, "Infer<typeof $1>");
+    return text;
+  }
+  checkManualReviewPatterns(text, filePath) {
+    for (const pattern of MANUAL_REVIEW_PATTERNS) {
+      if (text.includes(`.${pattern}(`) || text.includes(`z.${pattern}(`)) {
+        const guidance = this.getManualGuidance(pattern);
+        this.warnings.push(
+          `${filePath}: .${pattern}() requires manual conversion to Superstruct. ${guidance}`
+        );
+      }
+    }
+  }
+  getManualGuidance(pattern) {
+    const guidance = {
+      discriminatedUnion: "Superstruct has no discriminatedUnion. Use union() with explicit struct variants.",
+      superRefine: 'Use define() for custom validation: define("name", (value) => { ... }).',
+      transform: "Use coerce() for transforms: coerce(target, source, (value) => transformed).",
+      preprocess: "Use coerce() for preprocessing: coerce(target, source, (value) => preprocessed).",
+      lazy: "Use lazy() from superstruct for recursive types: lazy(() => myStruct).",
+      brand: "Superstruct has no brand() equivalent. Use define() with a branded type.",
+      catch: "Superstruct has no catch() equivalent. Handle defaults at the application level.",
+      pipe: "Superstruct has no pipe() equivalent. Use coerce() or define() instead."
+    };
+    return guidance[pattern] || "See Superstruct documentation for equivalent pattern.";
+  }
+  escapeRegex(str) {
+    return str.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+  }
+};
+
+// src/zod-to-superstruct-handler.ts
+function createZodToSuperstructHandler() {
+  return {
+    transform(sourceFile, _options) {
+      const transformer = new ZodToSuperstructTransformer();
+      return transformer.transform(sourceFile);
+    }
+  };
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  IMPORT_MAPPINGS,
+  MANUAL_REVIEW_PATTERNS,
+  SUPERSTRUCT_REFINEMENT_TO_ZOD,
+  SUPERSTRUCT_TO_ZOD_FACTORIES,
+  ZOD_TO_SUPERSTRUCT_FACTORIES,
+  ZOD_VALIDATION_TO_SUPERSTRUCT,
+  createSuperstructToZodHandler,
+  createZodToSuperstructHandler
+});
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts","../src/mappings.ts","../src/superstruct-to-zod-transformer.ts","../src/superstruct-to-zod-handler.ts","../src/zod-to-superstruct-transformer.ts","../src/zod-to-superstruct-handler.ts"],"sourcesContent":["export {\n  IMPORT_MAPPINGS,\n  MANUAL_REVIEW_PATTERNS,\n  SUPERSTRUCT_REFINEMENT_TO_ZOD,\n  SUPERSTRUCT_TO_ZOD_FACTORIES,\n  ZOD_TO_SUPERSTRUCT_FACTORIES,\n  ZOD_VALIDATION_TO_SUPERSTRUCT,\n} from './mappings.js';\nexport { createSuperstructToZodHandler } from './superstruct-to-zod-handler.js';\nexport { createZodToSuperstructHandler } from './zod-to-superstruct-handler.js';\n","/**\n * Zod ↔ Superstruct type mappings\n *\n * Superstruct uses function-based API similar to Zod but with different naming:\n *   Zod:         z.object({ name: z.string() })\n *   Superstruct: object({ name: string() })\n *\n * Key differences:\n * - Superstruct uses bare function calls (no namespace prefix)\n * - Superstruct uses `define()` for custom validators\n * - Superstruct uses `coerce()` differently than Zod\n * - Superstruct validation returns [error, value] tuple\n */\n\n/** Zod factory → Superstruct factory */\nexport const ZOD_TO_SUPERSTRUCT_FACTORIES: Record<string, string> = {\n  'z.string()': 'string()',\n  'z.number()': 'number()',\n  'z.boolean()': 'boolean()',\n  'z.date()': 'date()',\n  'z.any()': 'any()',\n  'z.unknown()': 'unknown()',\n  'z.never()': 'never()',\n  'z.bigint()': 'bigint()',\n  'z.undefined()': 'literal(undefined)',\n  'z.null()': 'literal(null)',\n  'z.void()': 'literal(undefined)',\n  'z.nan()': 'define(\"nan\", (v) => Number.isNaN(v))',\n};\n\n/** Superstruct factory → Zod factory */\nexport const SUPERSTRUCT_TO_ZOD_FACTORIES: Record<string, string> = {\n  'string()': 'z.string()',\n  'number()': 'z.number()',\n  'boolean()': 'z.boolean()',\n  'date()': 'z.date()',\n  'any()': 'z.any()',\n  'unknown()': 'z.unknown()',\n  'never()': 'z.never()',\n  'bigint()': 'z.bigint()',\n  'integer()': 'z.number().int()',\n  'func()': 'z.function()',\n  'instance(Date)': 'z.date()',\n  'instance(RegExp)': 'z.instanceof(RegExp)',\n};\n\n/** Zod validations → Superstruct refinements */\nexport const ZOD_VALIDATION_TO_SUPERSTRUCT: Record<string, string> = {\n  email: 'pattern(/^[^\\\\s@]+@[^\\\\s@]+\\\\.[^\\\\s@]+$/)',\n  url: 'pattern(/^https?:\\\\/\\\\/.+/)',\n  uuid: 'pattern(/^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i)',\n  ip: 'pattern(/^(?:\\\\d{1,3}\\\\.){3}\\\\d{1,3}$/)',\n  int: 'refine(\"integer\", (v) => Number.isInteger(v))',\n};\n\n/** Superstruct refinements → Zod validations */\nexport const SUPERSTRUCT_REFINEMENT_TO_ZOD: Record<string, string> = {\n  'size(string(), 1, Infinity)': 'z.string().min(1)',\n  'nonempty(string())': 'z.string().min(1)',\n  'nonempty(array())': 'z.array().min(1)',\n};\n\n/** Import mappings */\nexport const IMPORT_MAPPINGS = {\n  zodToSuperstruct: {\n    from: 'zod',\n    to: 'superstruct',\n    zodImport: 'z',\n    superstructImports: [\n      'object',\n      'string',\n      'number',\n      'boolean',\n      'date',\n      'array',\n      'optional',\n      'nullable',\n      'union',\n      'literal',\n      'enums',\n      'record',\n      'tuple',\n      'any',\n      'unknown',\n      'never',\n      'define',\n      'refine',\n      'coerce',\n      'bigint',\n      'type',\n      'assign',\n      'size',\n      'pattern',\n      'integer',\n    ],\n  },\n  superstructToZod: {\n    from: 'superstruct',\n    to: 'zod',\n    zodImport: 'z',\n  },\n};\n\n/** Patterns requiring manual review */\nexport const MANUAL_REVIEW_PATTERNS = [\n  'discriminatedUnion',\n  'superRefine',\n  'transform',\n  'preprocess',\n  'lazy',\n  'brand',\n  'catch',\n  'pipe',\n  'define',\n  'coerce',\n  'mask',\n  'create',\n  'assert',\n  'is',\n];\n","import type { TransformError, TransformResult } from '@schemashift/core';\nimport type { SourceFile } from 'ts-morph';\nimport { SUPERSTRUCT_TO_ZOD_FACTORIES } from './mappings.js';\n\n/**\n * Superstruct → Zod Transformer (Backward Migration)\n *\n * Converts Superstruct structs to Zod schemas.\n *   Superstruct: object({ name: string(), age: optional(number()) })\n *   Zod:         z.object({ name: z.string(), age: z.number().optional() })\n */\nexport class SuperstructToZodTransformer {\n  private errors: TransformError[] = [];\n  private warnings: string[] = [];\n\n  transform(sourceFile: SourceFile): TransformResult {\n    this.errors = [];\n    this.warnings = [];\n\n    const filePath = sourceFile.getFilePath();\n    const originalCode = sourceFile.getFullText();\n\n    try {\n      let text = originalCode;\n\n      // Step 1: Rewrite imports\n      text = this.rewriteImports(text, filePath);\n\n      // Step 2: Transform struct definitions\n      text = this.transformStructs(text, filePath);\n\n      // Step 3: Transform type helpers\n      text = this.transformTypeHelpers(text);\n\n      sourceFile.replaceWithText(text);\n\n      return {\n        success: this.errors.length === 0,\n        filePath,\n        originalCode,\n        transformedCode: sourceFile.getFullText(),\n        errors: this.errors,\n        warnings: this.warnings,\n      };\n    } catch (error) {\n      this.errors.push({\n        message: error instanceof Error ? error.message : 'Unknown error',\n      });\n      return {\n        success: false,\n        filePath,\n        originalCode,\n        errors: this.errors,\n        warnings: this.warnings,\n      };\n    }\n  }\n\n  private rewriteImports(text: string, filePath: string): string {\n    // import { object, string, ... } from 'superstruct' → import { z } from 'zod'\n    text = text.replace(\n      /import\\s*\\{[^}]+\\}\\s*from\\s*['\"]superstruct['\"]/g,\n      \"import { z } from 'zod'\",\n    );\n\n    // import type { Infer, ... } from 'superstruct' → import type { z } from 'zod'\n    text = text.replace(\n      /import\\s+type\\s*\\{[^}]+\\}\\s*from\\s*['\"]superstruct['\"]/g,\n      \"import type { z } from 'zod'\",\n    );\n\n    // Check for define() usage\n    if (text.includes('define(')) {\n      this.warnings.push(\n        `${filePath}: Superstruct define() should be converted to z.custom() or z.refine().`,\n      );\n    }\n\n    // Check for coerce() usage\n    if (text.includes('coerce(')) {\n      this.warnings.push(\n        `${filePath}: Superstruct coerce() should be converted to z.preprocess() or z.coerce.*.`,\n      );\n    }\n\n    // Check for mask() usage\n    if (text.includes('mask(')) {\n      this.warnings.push(\n        `${filePath}: Superstruct mask() (strip unknown keys) maps to z.object().strip() in Zod.`,\n      );\n    }\n\n    return text;\n  }\n\n  private transformStructs(text: string, filePath: string): string {\n    // Transform simple factories: string() → z.string(), etc.\n    for (const [ssFactory, zodFactory] of Object.entries(SUPERSTRUCT_TO_ZOD_FACTORIES)) {\n      // Only match bare function calls (not method calls like x.string())\n      const fnName = ssFactory.match(/^(\\w+)\\(/)?.[1];\n      if (fnName) {\n        const pattern = new RegExp(`(?<!\\\\.)\\\\b${this.escapeRegex(ssFactory)}`, 'g');\n        text = text.replace(pattern, zodFactory);\n      }\n    }\n\n    // Transform object({...}) → z.object({...})\n    text = text.replace(/(?<!\\.)(?<!\\w)\\bobject\\(/g, 'z.object(');\n\n    // Transform array(X) → z.array(X)\n    text = text.replace(/(?<!\\.)(?<!\\w)\\barray\\(/g, 'z.array(');\n\n    // Transform optional(X) → X.optional()\n    // This is tricky — Superstruct wraps: optional(string()) → z.string().optional()\n    text = text.replace(/\\boptional\\(z\\.(\\w+)\\(\\)\\)/g, 'z.$1().optional()');\n    text = text.replace(/\\boptional\\((z\\.\\w+\\([^)]*\\)(?:\\.\\w+\\([^)]*\\))*)\\)/g, '$1.optional()');\n\n    // Transform nullable(X) → X.nullable()\n    text = text.replace(/\\bnullable\\(z\\.(\\w+)\\(\\)\\)/g, 'z.$1().nullable()');\n    text = text.replace(/\\bnullable\\((z\\.\\w+\\([^)]*\\)(?:\\.\\w+\\([^)]*\\))*)\\)/g, '$1.nullable()');\n\n    // Transform enums([\"a\", \"b\"]) → z.enum([\"a\", \"b\"])\n    text = text.replace(/(?<!\\.)(?<!\\w)\\benums\\(/g, 'z.enum(');\n\n    // Transform literal(X) → z.literal(X)\n    text = text.replace(/(?<!\\.)(?<!\\w)\\bliteral\\(/g, 'z.literal(');\n\n    // Transform union([...]) → z.union([...])\n    text = text.replace(/(?<!\\.)(?<!\\w)\\bunion\\(/g, 'z.union(');\n\n    // Transform record(k, v) → z.record(k, v)\n    text = text.replace(/(?<!\\.)(?<!\\w)\\brecord\\(/g, 'z.record(');\n\n    // Transform tuple([...]) → z.tuple([...])\n    text = text.replace(/(?<!\\.)(?<!\\w)\\btuple\\(/g, 'z.tuple(');\n\n    // Transform integer() → z.number().int()\n    text = text.replace(/(?<!\\.)(?<!\\w)\\binteger\\(\\)/g, 'z.number().int()');\n\n    // Transform refine(schema, name, fn) → schema.refine(fn)\n    text = text.replace(/\\brefine\\((z\\.[^,]+),\\s*\"[^\"]*\",\\s*([^)]+)\\)/g, '$1.refine($2)');\n\n    // Transform size(string(), min, max) → z.string().min(min).max(max)\n    text = text.replace(/\\bsize\\(z\\.string\\(\\),\\s*(\\d+),\\s*Infinity\\)/g, 'z.string().min($1)');\n    text = text.replace(/\\bsize\\(z\\.string\\(\\),\\s*0,\\s*(\\d+)\\)/g, 'z.string().max($1)');\n    text = text.replace(/\\bsize\\(z\\.string\\(\\),\\s*(\\d+),\\s*(\\d+)\\)/g, 'z.string().min($1).max($2)');\n\n    // Transform pattern(string(), regex) → z.string().regex(regex)\n    text = text.replace(/\\bpattern\\(z\\.string\\(\\),\\s*([^)]+)\\)/g, 'z.string().regex($1)');\n\n    // Transform assign(A, B) → A.merge(B) or A.extend(B.shape)\n    if (text.includes('assign(')) {\n      this.warnings.push(\n        `${filePath}: Superstruct assign() should be converted to .merge() or .extend() in Zod.`,\n      );\n    }\n\n    // Transform type({...}) → z.object({...}).partial()\n    // Superstruct's type() makes all fields optional\n    if (/(?<!\\.)(?<!\\w)\\btype\\(/.test(text)) {\n      this.warnings.push(\n        `${filePath}: Superstruct type() (all-optional object) should be converted to z.object({}).partial() in Zod.`,\n      );\n      text = text.replace(/(?<!\\.)(?<!\\w)\\btype\\(\\{/g, 'z.object({');\n    }\n\n    return text;\n  }\n\n  private transformTypeHelpers(text: string): string {\n    // Infer<typeof schema> → z.infer<typeof schema>\n    text = text.replace(/\\bInfer<typeof\\s+(\\w+)>/g, 'z.infer<typeof $1>');\n\n    return text;\n  }\n\n  private escapeRegex(str: string): string {\n    return str.replace(/[.*+?^${}()|[\\]\\\\]/g, '\\\\$&');\n  }\n}\n","import type { TransformHandler, TransformOptions, TransformResult } from '@schemashift/core';\nimport type { SourceFile } from 'ts-morph';\nimport { SuperstructToZodTransformer } from './superstruct-to-zod-transformer.js';\n\nexport function createSuperstructToZodHandler(): TransformHandler {\n  return {\n    transform(sourceFile: SourceFile, _options: TransformOptions): TransformResult {\n      const transformer = new SuperstructToZodTransformer();\n      return transformer.transform(sourceFile);\n    },\n  };\n}\n","import type { TransformError, TransformResult } from '@schemashift/core';\nimport type { SourceFile } from 'ts-morph';\nimport {\n  MANUAL_REVIEW_PATTERNS,\n  ZOD_TO_SUPERSTRUCT_FACTORIES,\n  ZOD_VALIDATION_TO_SUPERSTRUCT,\n} from './mappings.js';\n\n/**\n * Zod → Superstruct Transformer\n *\n * Converts Zod schemas to Superstruct structs.\n * Superstruct uses a function-based API without a namespace prefix:\n *   Zod:         z.object({ name: z.string().email() })\n *   Superstruct: object({ name: refine(string(), \"email\", ...) })\n */\nexport class ZodToSuperstructTransformer {\n  private errors: TransformError[] = [];\n  private warnings: string[] = [];\n  private usedImports = new Set<string>();\n\n  transform(sourceFile: SourceFile): TransformResult {\n    this.errors = [];\n    this.warnings = [];\n    this.usedImports = new Set();\n\n    const filePath = sourceFile.getFilePath();\n    const originalCode = sourceFile.getFullText();\n\n    try {\n      let text = originalCode;\n\n      // Step 1: Transform schema definitions (before import rewriting to detect needed imports)\n      text = this.transformSchemas(text, filePath);\n\n      // Step 2: Transform type helpers\n      text = this.transformTypeHelpers(text);\n\n      // Step 3: Rewrite imports (after transforms, so we know which imports to add)\n      text = this.rewriteImports(text);\n\n      // Step 4: Check for manual review patterns\n      this.checkManualReviewPatterns(text, filePath);\n\n      sourceFile.replaceWithText(text);\n\n      return {\n        success: this.errors.length === 0,\n        filePath,\n        originalCode,\n        transformedCode: sourceFile.getFullText(),\n        errors: this.errors,\n        warnings: this.warnings,\n      };\n    } catch (error) {\n      this.errors.push({\n        message: error instanceof Error ? error.message : 'Unknown error',\n      });\n      return {\n        success: false,\n        filePath,\n        originalCode,\n        errors: this.errors,\n        warnings: this.warnings,\n      };\n    }\n  }\n\n  private rewriteImports(text: string): string {\n    // Collect all superstruct functions used\n    const imports = [...this.usedImports].sort();\n\n    // Replace zod import with superstruct import\n    text = text.replace(\n      /import\\s*\\{[^}]*\\bz\\b[^}]*\\}\\s*from\\s*['\"]zod['\"]/g,\n      `import { ${imports.join(', ')} } from 'superstruct'`,\n    );\n\n    // Handle namespace import\n    text = text.replace(\n      /import\\s*\\*\\s*as\\s*z\\s*from\\s*['\"]zod['\"]/g,\n      `import { ${imports.join(', ')} } from 'superstruct'`,\n    );\n\n    // Handle type imports\n    text = text.replace(\n      /import\\s+type\\s*\\{[^}]*\\}\\s*from\\s*['\"]zod['\"]/g,\n      `import type { Infer } from 'superstruct'`,\n    );\n\n    return text;\n  }\n\n  private transformSchemas(text: string, filePath: string): string {\n    // Transform simple factories\n    for (const [zodFactory, ssFactory] of Object.entries(ZOD_TO_SUPERSTRUCT_FACTORIES)) {\n      if (text.includes(zodFactory)) {\n        text = text.replace(new RegExp(this.escapeRegex(zodFactory), 'g'), ssFactory);\n        // Track imports needed\n        const fnName = ssFactory.match(/^(\\w+)\\(/)?.[1];\n        if (fnName) this.usedImports.add(fnName);\n      }\n    }\n\n    // Transform z.object({...}) → object({...})\n    text = text.replace(/\\bz\\.object\\(/g, 'object(');\n    this.usedImports.add('object');\n\n    // Transform z.array(X) → array(X)\n    text = text.replace(/\\bz\\.array\\(/g, 'array(');\n    this.usedImports.add('array');\n\n    // Transform .optional() → optional(X)\n    // This requires wrapping: X.optional() → optional(X)\n    text = text.replace(/(\\w+\\([^)]*\\))\\.optional\\(\\)/g, 'optional($1)');\n    this.usedImports.add('optional');\n\n    // Transform .nullable() → nullable(X)\n    text = text.replace(/(\\w+\\([^)]*\\))\\.nullable\\(\\)/g, 'nullable($1)');\n    this.usedImports.add('nullable');\n\n    // Transform z.enum([\"a\", \"b\"]) → enums([\"a\", \"b\"])\n    text = text.replace(/\\bz\\.enum\\(/g, 'enums(');\n    this.usedImports.add('enums');\n\n    // Transform z.literal(X) → literal(X)\n    text = text.replace(/\\bz\\.literal\\(/g, 'literal(');\n    this.usedImports.add('literal');\n\n    // Transform z.union([...]) → union([...])\n    text = text.replace(/\\bz\\.union\\(/g, 'union(');\n    this.usedImports.add('union');\n\n    // Transform z.record(k, v) → record(k, v)\n    text = text.replace(/\\bz\\.record\\(/g, 'record(');\n    this.usedImports.add('record');\n\n    // Transform z.tuple([...]) → tuple([...])\n    text = text.replace(/\\bz\\.tuple\\(/g, 'tuple(');\n    this.usedImports.add('tuple');\n\n    // Transform string validations\n    for (const [zodMethod, ssReplacement] of Object.entries(ZOD_VALIDATION_TO_SUPERSTRUCT)) {\n      const pattern = new RegExp(`string\\\\(\\\\)\\\\.${zodMethod}\\\\(\\\\)`, 'g');\n      if (pattern.test(text)) {\n        text = text.replace(\n          pattern,\n          `${ssReplacement.startsWith('pattern') ? ssReplacement.replace('pattern(', 'pattern(string(), ') : ssReplacement.replace('refine(', 'refine(string(), ')}`,\n        );\n        const fnName = ssReplacement.match(/^(\\w+)\\(/)?.[1];\n        if (fnName) this.usedImports.add(fnName);\n        this.usedImports.add('string');\n      }\n    }\n\n    // Transform .min()/.max()/.length() on strings\n    text = text.replace(/string\\(\\)\\.min\\((\\d+)\\)/g, (_m, n) => {\n      this.usedImports.add('size');\n      this.usedImports.add('string');\n      return `size(string(), ${n}, Infinity)`;\n    });\n    text = text.replace(/string\\(\\)\\.max\\((\\d+)\\)/g, (_m, n) => {\n      this.usedImports.add('size');\n      this.usedImports.add('string');\n      return `size(string(), 0, ${n})`;\n    });\n\n    // Transform z.number().int() → integer()\n    text = text.replace(/number\\(\\)\\.int\\(\\)/g, 'integer()');\n    this.usedImports.add('integer');\n\n    // Transform .refine() → refine()\n    text = text.replace(/(\\w+\\([^)]*\\))\\.refine\\(([^)]+)\\)/g, (_m, schema, fn) => {\n      this.usedImports.add('refine');\n      return `refine(${schema}, \"custom\", ${fn})`;\n    });\n\n    // Check for remaining z.* patterns\n    if (/\\bz\\./.test(text)) {\n      this.warnings.push(\n        `${filePath}: Some Zod patterns could not be auto-transformed to Superstruct. ` +\n          'Look for remaining z.* references and convert manually.',\n      );\n    }\n\n    return text;\n  }\n\n  private transformTypeHelpers(text: string): string {\n    // z.infer<typeof schema> → Infer<typeof schema>\n    text = text.replace(/z\\.infer<typeof\\s+(\\w+)>/g, 'Infer<typeof $1>');\n    text = text.replace(/z\\.input<typeof\\s+(\\w+)>/g, 'Infer<typeof $1>');\n    text = text.replace(/z\\.output<typeof\\s+(\\w+)>/g, 'Infer<typeof $1>');\n\n    return text;\n  }\n\n  private checkManualReviewPatterns(text: string, filePath: string): void {\n    for (const pattern of MANUAL_REVIEW_PATTERNS) {\n      if (text.includes(`.${pattern}(`) || text.includes(`z.${pattern}(`)) {\n        const guidance = this.getManualGuidance(pattern);\n        this.warnings.push(\n          `${filePath}: .${pattern}() requires manual conversion to Superstruct. ${guidance}`,\n        );\n      }\n    }\n  }\n\n  private getManualGuidance(pattern: string): string {\n    const guidance: Record<string, string> = {\n      discriminatedUnion:\n        'Superstruct has no discriminatedUnion. Use union() with explicit struct variants.',\n      superRefine: 'Use define() for custom validation: define(\"name\", (value) => { ... }).',\n      transform: 'Use coerce() for transforms: coerce(target, source, (value) => transformed).',\n      preprocess:\n        'Use coerce() for preprocessing: coerce(target, source, (value) => preprocessed).',\n      lazy: 'Use lazy() from superstruct for recursive types: lazy(() => myStruct).',\n      brand: 'Superstruct has no brand() equivalent. Use define() with a branded type.',\n      catch: 'Superstruct has no catch() equivalent. Handle defaults at the application level.',\n      pipe: 'Superstruct has no pipe() equivalent. Use coerce() or define() instead.',\n    };\n    return guidance[pattern] || 'See Superstruct documentation for equivalent pattern.';\n  }\n\n  private escapeRegex(str: string): string {\n    return str.replace(/[.*+?^${}()|[\\]\\\\]/g, '\\\\$&');\n  }\n}\n","import type { TransformHandler, TransformOptions, TransformResult } from '@schemashift/core';\nimport type { SourceFile } from 'ts-morph';\nimport { ZodToSuperstructTransformer } from './zod-to-superstruct-transformer.js';\n\nexport function createZodToSuperstructHandler(): TransformHandler {\n  return {\n    transform(sourceFile: SourceFile, _options: TransformOptions): TransformResult {\n      const transformer = new ZodToSuperstructTransformer();\n      return transformer.transform(sourceFile);\n    },\n  };\n}\n"],"mappings":"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","names":[]}

package/dist/index.d.cts

@@ -0,0 +1,45 @@
+import { TransformHandler } from '@schemashift/core';
+
+/**
+ * Zod ↔ Superstruct type mappings
+ *
+ * Superstruct uses function-based API similar to Zod but with different naming:
+ *   Zod:         z.object({ name: z.string() })
+ *   Superstruct: object({ name: string() })
+ *
+ * Key differences:
+ * - Superstruct uses bare function calls (no namespace prefix)
+ * - Superstruct uses `define()` for custom validators
+ * - Superstruct uses `coerce()` differently than Zod
+ * - Superstruct validation returns [error, value] tuple
+ */
+/** Zod factory → Superstruct factory */
+declare const ZOD_TO_SUPERSTRUCT_FACTORIES: Record<string, string>;
+/** Superstruct factory → Zod factory */
+declare const SUPERSTRUCT_TO_ZOD_FACTORIES: Record<string, string>;
+/** Zod validations → Superstruct refinements */
+declare const ZOD_VALIDATION_TO_SUPERSTRUCT: Record<string, string>;
+/** Superstruct refinements → Zod validations */
+declare const SUPERSTRUCT_REFINEMENT_TO_ZOD: Record<string, string>;
+/** Import mappings */
+declare const IMPORT_MAPPINGS: {
+    zodToSuperstruct: {
+        from: string;
+        to: string;
+        zodImport: string;
+        superstructImports: string[];
+    };
+    superstructToZod: {
+        from: string;
+        to: string;
+        zodImport: string;
+    };
+};
+/** Patterns requiring manual review */
+declare const MANUAL_REVIEW_PATTERNS: string[];
+
+declare function createSuperstructToZodHandler(): TransformHandler;
+
+declare function createZodToSuperstructHandler(): TransformHandler;
+
+export { IMPORT_MAPPINGS, MANUAL_REVIEW_PATTERNS, SUPERSTRUCT_REFINEMENT_TO_ZOD, SUPERSTRUCT_TO_ZOD_FACTORIES, ZOD_TO_SUPERSTRUCT_FACTORIES, ZOD_VALIDATION_TO_SUPERSTRUCT, createSuperstructToZodHandler, createZodToSuperstructHandler };

package/dist/index.d.ts

@@ -0,0 +1,45 @@
+import { TransformHandler } from '@schemashift/core';
+
+/**
+ * Zod ↔ Superstruct type mappings
+ *
+ * Superstruct uses function-based API similar to Zod but with different naming:
+ *   Zod:         z.object({ name: z.string() })
+ *   Superstruct: object({ name: string() })
+ *
+ * Key differences:
+ * - Superstruct uses bare function calls (no namespace prefix)
+ * - Superstruct uses `define()` for custom validators
+ * - Superstruct uses `coerce()` differently than Zod
+ * - Superstruct validation returns [error, value] tuple
+ */
+/** Zod factory → Superstruct factory */
+declare const ZOD_TO_SUPERSTRUCT_FACTORIES: Record<string, string>;
+/** Superstruct factory → Zod factory */
+declare const SUPERSTRUCT_TO_ZOD_FACTORIES: Record<string, string>;
+/** Zod validations → Superstruct refinements */
+declare const ZOD_VALIDATION_TO_SUPERSTRUCT: Record<string, string>;
+/** Superstruct refinements → Zod validations */
+declare const SUPERSTRUCT_REFINEMENT_TO_ZOD: Record<string, string>;
+/** Import mappings */
+declare const IMPORT_MAPPINGS: {
+    zodToSuperstruct: {
+        from: string;
+        to: string;
+        zodImport: string;
+        superstructImports: string[];
+    };
+    superstructToZod: {
+        from: string;
+        to: string;
+        zodImport: string;
+    };
+};
+/** Patterns requiring manual review */
+declare const MANUAL_REVIEW_PATTERNS: string[];
+
+declare function createSuperstructToZodHandler(): TransformHandler;
+
+declare function createZodToSuperstructHandler(): TransformHandler;
+
+export { IMPORT_MAPPINGS, MANUAL_REVIEW_PATTERNS, SUPERSTRUCT_REFINEMENT_TO_ZOD, SUPERSTRUCT_TO_ZOD_FACTORIES, ZOD_TO_SUPERSTRUCT_FACTORIES, ZOD_VALIDATION_TO_SUPERSTRUCT, createSuperstructToZodHandler, createZodToSuperstructHandler };

package/dist/index.js

@@ -0,0 +1,386 @@
+// src/mappings.ts
+var ZOD_TO_SUPERSTRUCT_FACTORIES = {
+  "z.string()": "string()",
+  "z.number()": "number()",
+  "z.boolean()": "boolean()",
+  "z.date()": "date()",
+  "z.any()": "any()",
+  "z.unknown()": "unknown()",
+  "z.never()": "never()",
+  "z.bigint()": "bigint()",
+  "z.undefined()": "literal(undefined)",
+  "z.null()": "literal(null)",
+  "z.void()": "literal(undefined)",
+  "z.nan()": 'define("nan", (v) => Number.isNaN(v))'
+};
+var SUPERSTRUCT_TO_ZOD_FACTORIES = {
+  "string()": "z.string()",
+  "number()": "z.number()",
+  "boolean()": "z.boolean()",
+  "date()": "z.date()",
+  "any()": "z.any()",
+  "unknown()": "z.unknown()",
+  "never()": "z.never()",
+  "bigint()": "z.bigint()",
+  "integer()": "z.number().int()",
+  "func()": "z.function()",
+  "instance(Date)": "z.date()",
+  "instance(RegExp)": "z.instanceof(RegExp)"
+};
+var ZOD_VALIDATION_TO_SUPERSTRUCT = {
+  email: "pattern(/^[^\\s@]+@[^\\s@]+\\.[^\\s@]+$/)",
+  url: "pattern(/^https?:\\/\\/.+/)",
+  uuid: "pattern(/^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i)",
+  ip: "pattern(/^(?:\\d{1,3}\\.){3}\\d{1,3}$/)",
+  int: 'refine("integer", (v) => Number.isInteger(v))'
+};
+var SUPERSTRUCT_REFINEMENT_TO_ZOD = {
+  "size(string(), 1, Infinity)": "z.string().min(1)",
+  "nonempty(string())": "z.string().min(1)",
+  "nonempty(array())": "z.array().min(1)"
+};
+var IMPORT_MAPPINGS = {
+  zodToSuperstruct: {
+    from: "zod",
+    to: "superstruct",
+    zodImport: "z",
+    superstructImports: [
+      "object",
+      "string",
+      "number",
+      "boolean",
+      "date",
+      "array",
+      "optional",
+      "nullable",
+      "union",
+      "literal",
+      "enums",
+      "record",
+      "tuple",
+      "any",
+      "unknown",
+      "never",
+      "define",
+      "refine",
+      "coerce",
+      "bigint",
+      "type",
+      "assign",
+      "size",
+      "pattern",
+      "integer"
+    ]
+  },
+  superstructToZod: {
+    from: "superstruct",
+    to: "zod",
+    zodImport: "z"
+  }
+};
+var MANUAL_REVIEW_PATTERNS = [
+  "discriminatedUnion",
+  "superRefine",
+  "transform",
+  "preprocess",
+  "lazy",
+  "brand",
+  "catch",
+  "pipe",
+  "define",
+  "coerce",
+  "mask",
+  "create",
+  "assert",
+  "is"
+];
+
+// src/superstruct-to-zod-transformer.ts
+var SuperstructToZodTransformer = class {
+  errors = [];
+  warnings = [];
+  transform(sourceFile) {
+    this.errors = [];
+    this.warnings = [];
+    const filePath = sourceFile.getFilePath();
+    const originalCode = sourceFile.getFullText();
+    try {
+      let text = originalCode;
+      text = this.rewriteImports(text, filePath);
+      text = this.transformStructs(text, filePath);
+      text = this.transformTypeHelpers(text);
+      sourceFile.replaceWithText(text);
+      return {
+        success: this.errors.length === 0,
+        filePath,
+        originalCode,
+        transformedCode: sourceFile.getFullText(),
+        errors: this.errors,
+        warnings: this.warnings
+      };
+    } catch (error) {
+      this.errors.push({
+        message: error instanceof Error ? error.message : "Unknown error"
+      });
+      return {
+        success: false,
+        filePath,
+        originalCode,
+        errors: this.errors,
+        warnings: this.warnings
+      };
+    }
+  }
+  rewriteImports(text, filePath) {
+    text = text.replace(
+      /import\s*\{[^}]+\}\s*from\s*['"]superstruct['"]/g,
+      "import { z } from 'zod'"
+    );
+    text = text.replace(
+      /import\s+type\s*\{[^}]+\}\s*from\s*['"]superstruct['"]/g,
+      "import type { z } from 'zod'"
+    );
+    if (text.includes("define(")) {
+      this.warnings.push(
+        `${filePath}: Superstruct define() should be converted to z.custom() or z.refine().`
+      );
+    }
+    if (text.includes("coerce(")) {
+      this.warnings.push(
+        `${filePath}: Superstruct coerce() should be converted to z.preprocess() or z.coerce.*.`
+      );
+    }
+    if (text.includes("mask(")) {
+      this.warnings.push(
+        `${filePath}: Superstruct mask() (strip unknown keys) maps to z.object().strip() in Zod.`
+      );
+    }
+    return text;
+  }
+  transformStructs(text, filePath) {
+    for (const [ssFactory, zodFactory] of Object.entries(SUPERSTRUCT_TO_ZOD_FACTORIES)) {
+      const fnName = ssFactory.match(/^(\w+)\(/)?.[1];
+      if (fnName) {
+        const pattern = new RegExp(`(?<!\\.)\\b${this.escapeRegex(ssFactory)}`, "g");
+        text = text.replace(pattern, zodFactory);
+      }
+    }
+    text = text.replace(/(?<!\.)(?<!\w)\bobject\(/g, "z.object(");
+    text = text.replace(/(?<!\.)(?<!\w)\barray\(/g, "z.array(");
+    text = text.replace(/\boptional\(z\.(\w+)\(\)\)/g, "z.$1().optional()");
+    text = text.replace(/\boptional\((z\.\w+\([^)]*\)(?:\.\w+\([^)]*\))*)\)/g, "$1.optional()");
+    text = text.replace(/\bnullable\(z\.(\w+)\(\)\)/g, "z.$1().nullable()");
+    text = text.replace(/\bnullable\((z\.\w+\([^)]*\)(?:\.\w+\([^)]*\))*)\)/g, "$1.nullable()");
+    text = text.replace(/(?<!\.)(?<!\w)\benums\(/g, "z.enum(");
+    text = text.replace(/(?<!\.)(?<!\w)\bliteral\(/g, "z.literal(");
+    text = text.replace(/(?<!\.)(?<!\w)\bunion\(/g, "z.union(");
+    text = text.replace(/(?<!\.)(?<!\w)\brecord\(/g, "z.record(");
+    text = text.replace(/(?<!\.)(?<!\w)\btuple\(/g, "z.tuple(");
+    text = text.replace(/(?<!\.)(?<!\w)\binteger\(\)/g, "z.number().int()");
+    text = text.replace(/\brefine\((z\.[^,]+),\s*"[^"]*",\s*([^)]+)\)/g, "$1.refine($2)");
+    text = text.replace(/\bsize\(z\.string\(\),\s*(\d+),\s*Infinity\)/g, "z.string().min($1)");
+    text = text.replace(/\bsize\(z\.string\(\),\s*0,\s*(\d+)\)/g, "z.string().max($1)");
+    text = text.replace(/\bsize\(z\.string\(\),\s*(\d+),\s*(\d+)\)/g, "z.string().min($1).max($2)");
+    text = text.replace(/\bpattern\(z\.string\(\),\s*([^)]+)\)/g, "z.string().regex($1)");
+    if (text.includes("assign(")) {
+      this.warnings.push(
+        `${filePath}: Superstruct assign() should be converted to .merge() or .extend() in Zod.`
+      );
+    }
+    if (/(?<!\.)(?<!\w)\btype\(/.test(text)) {
+      this.warnings.push(
+        `${filePath}: Superstruct type() (all-optional object) should be converted to z.object({}).partial() in Zod.`
+      );
+      text = text.replace(/(?<!\.)(?<!\w)\btype\(\{/g, "z.object({");
+    }
+    return text;
+  }
+  transformTypeHelpers(text) {
+    text = text.replace(/\bInfer<typeof\s+(\w+)>/g, "z.infer<typeof $1>");
+    return text;
+  }
+  escapeRegex(str) {
+    return str.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+  }
+};
+
+// src/superstruct-to-zod-handler.ts
+function createSuperstructToZodHandler() {
+  return {
+    transform(sourceFile, _options) {
+      const transformer = new SuperstructToZodTransformer();
+      return transformer.transform(sourceFile);
+    }
+  };
+}
+
+// src/zod-to-superstruct-transformer.ts
+var ZodToSuperstructTransformer = class {
+  errors = [];
+  warnings = [];
+  usedImports = /* @__PURE__ */ new Set();
+  transform(sourceFile) {
+    this.errors = [];
+    this.warnings = [];
+    this.usedImports = /* @__PURE__ */ new Set();
+    const filePath = sourceFile.getFilePath();
+    const originalCode = sourceFile.getFullText();
+    try {
+      let text = originalCode;
+      text = this.transformSchemas(text, filePath);
+      text = this.transformTypeHelpers(text);
+      text = this.rewriteImports(text);
+      this.checkManualReviewPatterns(text, filePath);
+      sourceFile.replaceWithText(text);
+      return {
+        success: this.errors.length === 0,
+        filePath,
+        originalCode,
+        transformedCode: sourceFile.getFullText(),
+        errors: this.errors,
+        warnings: this.warnings
+      };
+    } catch (error) {
+      this.errors.push({
+        message: error instanceof Error ? error.message : "Unknown error"
+      });
+      return {
+        success: false,
+        filePath,
+        originalCode,
+        errors: this.errors,
+        warnings: this.warnings
+      };
+    }
+  }
+  rewriteImports(text) {
+    const imports = [...this.usedImports].sort();
+    text = text.replace(
+      /import\s*\{[^}]*\bz\b[^}]*\}\s*from\s*['"]zod['"]/g,
+      `import { ${imports.join(", ")} } from 'superstruct'`
+    );
+    text = text.replace(
+      /import\s*\*\s*as\s*z\s*from\s*['"]zod['"]/g,
+      `import { ${imports.join(", ")} } from 'superstruct'`
+    );
+    text = text.replace(
+      /import\s+type\s*\{[^}]*\}\s*from\s*['"]zod['"]/g,
+      `import type { Infer } from 'superstruct'`
+    );
+    return text;
+  }
+  transformSchemas(text, filePath) {
+    for (const [zodFactory, ssFactory] of Object.entries(ZOD_TO_SUPERSTRUCT_FACTORIES)) {
+      if (text.includes(zodFactory)) {
+        text = text.replace(new RegExp(this.escapeRegex(zodFactory), "g"), ssFactory);
+        const fnName = ssFactory.match(/^(\w+)\(/)?.[1];
+        if (fnName) this.usedImports.add(fnName);
+      }
+    }
+    text = text.replace(/\bz\.object\(/g, "object(");
+    this.usedImports.add("object");
+    text = text.replace(/\bz\.array\(/g, "array(");
+    this.usedImports.add("array");
+    text = text.replace(/(\w+\([^)]*\))\.optional\(\)/g, "optional($1)");
+    this.usedImports.add("optional");
+    text = text.replace(/(\w+\([^)]*\))\.nullable\(\)/g, "nullable($1)");
+    this.usedImports.add("nullable");
+    text = text.replace(/\bz\.enum\(/g, "enums(");
+    this.usedImports.add("enums");
+    text = text.replace(/\bz\.literal\(/g, "literal(");
+    this.usedImports.add("literal");
+    text = text.replace(/\bz\.union\(/g, "union(");
+    this.usedImports.add("union");
+    text = text.replace(/\bz\.record\(/g, "record(");
+    this.usedImports.add("record");
+    text = text.replace(/\bz\.tuple\(/g, "tuple(");
+    this.usedImports.add("tuple");
+    for (const [zodMethod, ssReplacement] of Object.entries(ZOD_VALIDATION_TO_SUPERSTRUCT)) {
+      const pattern = new RegExp(`string\\(\\)\\.${zodMethod}\\(\\)`, "g");
+      if (pattern.test(text)) {
+        text = text.replace(
+          pattern,
+          `${ssReplacement.startsWith("pattern") ? ssReplacement.replace("pattern(", "pattern(string(), ") : ssReplacement.replace("refine(", "refine(string(), ")}`
+        );
+        const fnName = ssReplacement.match(/^(\w+)\(/)?.[1];
+        if (fnName) this.usedImports.add(fnName);
+        this.usedImports.add("string");
+      }
+    }
+    text = text.replace(/string\(\)\.min\((\d+)\)/g, (_m, n) => {
+      this.usedImports.add("size");
+      this.usedImports.add("string");
+      return `size(string(), ${n}, Infinity)`;
+    });
+    text = text.replace(/string\(\)\.max\((\d+)\)/g, (_m, n) => {
+      this.usedImports.add("size");
+      this.usedImports.add("string");
+      return `size(string(), 0, ${n})`;
+    });
+    text = text.replace(/number\(\)\.int\(\)/g, "integer()");
+    this.usedImports.add("integer");
+    text = text.replace(/(\w+\([^)]*\))\.refine\(([^)]+)\)/g, (_m, schema, fn) => {
+      this.usedImports.add("refine");
+      return `refine(${schema}, "custom", ${fn})`;
+    });
+    if (/\bz\./.test(text)) {
+      this.warnings.push(
+        `${filePath}: Some Zod patterns could not be auto-transformed to Superstruct. Look for remaining z.* references and convert manually.`
+      );
+    }
+    return text;
+  }
+  transformTypeHelpers(text) {
+    text = text.replace(/z\.infer<typeof\s+(\w+)>/g, "Infer<typeof $1>");
+    text = text.replace(/z\.input<typeof\s+(\w+)>/g, "Infer<typeof $1>");
+    text = text.replace(/z\.output<typeof\s+(\w+)>/g, "Infer<typeof $1>");
+    return text;
+  }
+  checkManualReviewPatterns(text, filePath) {
+    for (const pattern of MANUAL_REVIEW_PATTERNS) {
+      if (text.includes(`.${pattern}(`) || text.includes(`z.${pattern}(`)) {
+        const guidance = this.getManualGuidance(pattern);
+        this.warnings.push(
+          `${filePath}: .${pattern}() requires manual conversion to Superstruct. ${guidance}`
+        );
+      }
+    }
+  }
+  getManualGuidance(pattern) {
+    const guidance = {
+      discriminatedUnion: "Superstruct has no discriminatedUnion. Use union() with explicit struct variants.",
+      superRefine: 'Use define() for custom validation: define("name", (value) => { ... }).',
+      transform: "Use coerce() for transforms: coerce(target, source, (value) => transformed).",
+      preprocess: "Use coerce() for preprocessing: coerce(target, source, (value) => preprocessed).",
+      lazy: "Use lazy() from superstruct for recursive types: lazy(() => myStruct).",
+      brand: "Superstruct has no brand() equivalent. Use define() with a branded type.",
+      catch: "Superstruct has no catch() equivalent. Handle defaults at the application level.",
+      pipe: "Superstruct has no pipe() equivalent. Use coerce() or define() instead."
+    };
+    return guidance[pattern] || "See Superstruct documentation for equivalent pattern.";
+  }
+  escapeRegex(str) {
+    return str.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+  }
+};
+
+// src/zod-to-superstruct-handler.ts
+function createZodToSuperstructHandler() {
+  return {
+    transform(sourceFile, _options) {
+      const transformer = new ZodToSuperstructTransformer();
+      return transformer.transform(sourceFile);
+    }
+  };
+}
+export {
+  IMPORT_MAPPINGS,
+  MANUAL_REVIEW_PATTERNS,
+  SUPERSTRUCT_REFINEMENT_TO_ZOD,
+  SUPERSTRUCT_TO_ZOD_FACTORIES,
+  ZOD_TO_SUPERSTRUCT_FACTORIES,
+  ZOD_VALIDATION_TO_SUPERSTRUCT,
+  createSuperstructToZodHandler,
+  createZodToSuperstructHandler
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/mappings.ts","../src/superstruct-to-zod-transformer.ts","../src/superstruct-to-zod-handler.ts","../src/zod-to-superstruct-transformer.ts","../src/zod-to-superstruct-handler.ts"],"sourcesContent":["/**\n * Zod ↔ Superstruct type mappings\n *\n * Superstruct uses function-based API similar to Zod but with different naming:\n *   Zod:         z.object({ name: z.string() })\n *   Superstruct: object({ name: string() })\n *\n * Key differences:\n * - Superstruct uses bare function calls (no namespace prefix)\n * - Superstruct uses `define()` for custom validators\n * - Superstruct uses `coerce()` differently than Zod\n * - Superstruct validation returns [error, value] tuple\n */\n\n/** Zod factory → Superstruct factory */\nexport const ZOD_TO_SUPERSTRUCT_FACTORIES: Record<string, string> = {\n  'z.string()': 'string()',\n  'z.number()': 'number()',\n  'z.boolean()': 'boolean()',\n  'z.date()': 'date()',\n  'z.any()': 'any()',\n  'z.unknown()': 'unknown()',\n  'z.never()': 'never()',\n  'z.bigint()': 'bigint()',\n  'z.undefined()': 'literal(undefined)',\n  'z.null()': 'literal(null)',\n  'z.void()': 'literal(undefined)',\n  'z.nan()': 'define(\"nan\", (v) => Number.isNaN(v))',\n};\n\n/** Superstruct factory → Zod factory */\nexport const SUPERSTRUCT_TO_ZOD_FACTORIES: Record<string, string> = {\n  'string()': 'z.string()',\n  'number()': 'z.number()',\n  'boolean()': 'z.boolean()',\n  'date()': 'z.date()',\n  'any()': 'z.any()',\n  'unknown()': 'z.unknown()',\n  'never()': 'z.never()',\n  'bigint()': 'z.bigint()',\n  'integer()': 'z.number().int()',\n  'func()': 'z.function()',\n  'instance(Date)': 'z.date()',\n  'instance(RegExp)': 'z.instanceof(RegExp)',\n};\n\n/** Zod validations → Superstruct refinements */\nexport const ZOD_VALIDATION_TO_SUPERSTRUCT: Record<string, string> = {\n  email: 'pattern(/^[^\\\\s@]+@[^\\\\s@]+\\\\.[^\\\\s@]+$/)',\n  url: 'pattern(/^https?:\\\\/\\\\/.+/)',\n  uuid: 'pattern(/^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i)',\n  ip: 'pattern(/^(?:\\\\d{1,3}\\\\.){3}\\\\d{1,3}$/)',\n  int: 'refine(\"integer\", (v) => Number.isInteger(v))',\n};\n\n/** Superstruct refinements → Zod validations */\nexport const SUPERSTRUCT_REFINEMENT_TO_ZOD: Record<string, string> = {\n  'size(string(), 1, Infinity)': 'z.string().min(1)',\n  'nonempty(string())': 'z.string().min(1)',\n  'nonempty(array())': 'z.array().min(1)',\n};\n\n/** Import mappings */\nexport const IMPORT_MAPPINGS = {\n  zodToSuperstruct: {\n    from: 'zod',\n    to: 'superstruct',\n    zodImport: 'z',\n    superstructImports: [\n      'object',\n      'string',\n      'number',\n      'boolean',\n      'date',\n      'array',\n      'optional',\n      'nullable',\n      'union',\n      'literal',\n      'enums',\n      'record',\n      'tuple',\n      'any',\n      'unknown',\n      'never',\n      'define',\n      'refine',\n      'coerce',\n      'bigint',\n      'type',\n      'assign',\n      'size',\n      'pattern',\n      'integer',\n    ],\n  },\n  superstructToZod: {\n    from: 'superstruct',\n    to: 'zod',\n    zodImport: 'z',\n  },\n};\n\n/** Patterns requiring manual review */\nexport const MANUAL_REVIEW_PATTERNS = [\n  'discriminatedUnion',\n  'superRefine',\n  'transform',\n  'preprocess',\n  'lazy',\n  'brand',\n  'catch',\n  'pipe',\n  'define',\n  'coerce',\n  'mask',\n  'create',\n  'assert',\n  'is',\n];\n","import type { TransformError, TransformResult } from '@schemashift/core';\nimport type { SourceFile } from 'ts-morph';\nimport { SUPERSTRUCT_TO_ZOD_FACTORIES } from './mappings.js';\n\n/**\n * Superstruct → Zod Transformer (Backward Migration)\n *\n * Converts Superstruct structs to Zod schemas.\n *   Superstruct: object({ name: string(), age: optional(number()) })\n *   Zod:         z.object({ name: z.string(), age: z.number().optional() })\n */\nexport class SuperstructToZodTransformer {\n  private errors: TransformError[] = [];\n  private warnings: string[] = [];\n\n  transform(sourceFile: SourceFile): TransformResult {\n    this.errors = [];\n    this.warnings = [];\n\n    const filePath = sourceFile.getFilePath();\n    const originalCode = sourceFile.getFullText();\n\n    try {\n      let text = originalCode;\n\n      // Step 1: Rewrite imports\n      text = this.rewriteImports(text, filePath);\n\n      // Step 2: Transform struct definitions\n      text = this.transformStructs(text, filePath);\n\n      // Step 3: Transform type helpers\n      text = this.transformTypeHelpers(text);\n\n      sourceFile.replaceWithText(text);\n\n      return {\n        success: this.errors.length === 0,\n        filePath,\n        originalCode,\n        transformedCode: sourceFile.getFullText(),\n        errors: this.errors,\n        warnings: this.warnings,\n      };\n    } catch (error) {\n      this.errors.push({\n        message: error instanceof Error ? error.message : 'Unknown error',\n      });\n      return {\n        success: false,\n        filePath,\n        originalCode,\n        errors: this.errors,\n        warnings: this.warnings,\n      };\n    }\n  }\n\n  private rewriteImports(text: string, filePath: string): string {\n    // import { object, string, ... } from 'superstruct' → import { z } from 'zod'\n    text = text.replace(\n      /import\\s*\\{[^}]+\\}\\s*from\\s*['\"]superstruct['\"]/g,\n      \"import { z } from 'zod'\",\n    );\n\n    // import type { Infer, ... } from 'superstruct' → import type { z } from 'zod'\n    text = text.replace(\n      /import\\s+type\\s*\\{[^}]+\\}\\s*from\\s*['\"]superstruct['\"]/g,\n      \"import type { z } from 'zod'\",\n    );\n\n    // Check for define() usage\n    if (text.includes('define(')) {\n      this.warnings.push(\n        `${filePath}: Superstruct define() should be converted to z.custom() or z.refine().`,\n      );\n    }\n\n    // Check for coerce() usage\n    if (text.includes('coerce(')) {\n      this.warnings.push(\n        `${filePath}: Superstruct coerce() should be converted to z.preprocess() or z.coerce.*.`,\n      );\n    }\n\n    // Check for mask() usage\n    if (text.includes('mask(')) {\n      this.warnings.push(\n        `${filePath}: Superstruct mask() (strip unknown keys) maps to z.object().strip() in Zod.`,\n      );\n    }\n\n    return text;\n  }\n\n  private transformStructs(text: string, filePath: string): string {\n    // Transform simple factories: string() → z.string(), etc.\n    for (const [ssFactory, zodFactory] of Object.entries(SUPERSTRUCT_TO_ZOD_FACTORIES)) {\n      // Only match bare function calls (not method calls like x.string())\n      const fnName = ssFactory.match(/^(\\w+)\\(/)?.[1];\n      if (fnName) {\n        const pattern = new RegExp(`(?<!\\\\.)\\\\b${this.escapeRegex(ssFactory)}`, 'g');\n        text = text.replace(pattern, zodFactory);\n      }\n    }\n\n    // Transform object({...}) → z.object({...})\n    text = text.replace(/(?<!\\.)(?<!\\w)\\bobject\\(/g, 'z.object(');\n\n    // Transform array(X) → z.array(X)\n    text = text.replace(/(?<!\\.)(?<!\\w)\\barray\\(/g, 'z.array(');\n\n    // Transform optional(X) → X.optional()\n    // This is tricky — Superstruct wraps: optional(string()) → z.string().optional()\n    text = text.replace(/\\boptional\\(z\\.(\\w+)\\(\\)\\)/g, 'z.$1().optional()');\n    text = text.replace(/\\boptional\\((z\\.\\w+\\([^)]*\\)(?:\\.\\w+\\([^)]*\\))*)\\)/g, '$1.optional()');\n\n    // Transform nullable(X) → X.nullable()\n    text = text.replace(/\\bnullable\\(z\\.(\\w+)\\(\\)\\)/g, 'z.$1().nullable()');\n    text = text.replace(/\\bnullable\\((z\\.\\w+\\([^)]*\\)(?:\\.\\w+\\([^)]*\\))*)\\)/g, '$1.nullable()');\n\n    // Transform enums([\"a\", \"b\"]) → z.enum([\"a\", \"b\"])\n    text = text.replace(/(?<!\\.)(?<!\\w)\\benums\\(/g, 'z.enum(');\n\n    // Transform literal(X) → z.literal(X)\n    text = text.replace(/(?<!\\.)(?<!\\w)\\bliteral\\(/g, 'z.literal(');\n\n    // Transform union([...]) → z.union([...])\n    text = text.replace(/(?<!\\.)(?<!\\w)\\bunion\\(/g, 'z.union(');\n\n    // Transform record(k, v) → z.record(k, v)\n    text = text.replace(/(?<!\\.)(?<!\\w)\\brecord\\(/g, 'z.record(');\n\n    // Transform tuple([...]) → z.tuple([...])\n    text = text.replace(/(?<!\\.)(?<!\\w)\\btuple\\(/g, 'z.tuple(');\n\n    // Transform integer() → z.number().int()\n    text = text.replace(/(?<!\\.)(?<!\\w)\\binteger\\(\\)/g, 'z.number().int()');\n\n    // Transform refine(schema, name, fn) → schema.refine(fn)\n    text = text.replace(/\\brefine\\((z\\.[^,]+),\\s*\"[^\"]*\",\\s*([^)]+)\\)/g, '$1.refine($2)');\n\n    // Transform size(string(), min, max) → z.string().min(min).max(max)\n    text = text.replace(/\\bsize\\(z\\.string\\(\\),\\s*(\\d+),\\s*Infinity\\)/g, 'z.string().min($1)');\n    text = text.replace(/\\bsize\\(z\\.string\\(\\),\\s*0,\\s*(\\d+)\\)/g, 'z.string().max($1)');\n    text = text.replace(/\\bsize\\(z\\.string\\(\\),\\s*(\\d+),\\s*(\\d+)\\)/g, 'z.string().min($1).max($2)');\n\n    // Transform pattern(string(), regex) → z.string().regex(regex)\n    text = text.replace(/\\bpattern\\(z\\.string\\(\\),\\s*([^)]+)\\)/g, 'z.string().regex($1)');\n\n    // Transform assign(A, B) → A.merge(B) or A.extend(B.shape)\n    if (text.includes('assign(')) {\n      this.warnings.push(\n        `${filePath}: Superstruct assign() should be converted to .merge() or .extend() in Zod.`,\n      );\n    }\n\n    // Transform type({...}) → z.object({...}).partial()\n    // Superstruct's type() makes all fields optional\n    if (/(?<!\\.)(?<!\\w)\\btype\\(/.test(text)) {\n      this.warnings.push(\n        `${filePath}: Superstruct type() (all-optional object) should be converted to z.object({}).partial() in Zod.`,\n      );\n      text = text.replace(/(?<!\\.)(?<!\\w)\\btype\\(\\{/g, 'z.object({');\n    }\n\n    return text;\n  }\n\n  private transformTypeHelpers(text: string): string {\n    // Infer<typeof schema> → z.infer<typeof schema>\n    text = text.replace(/\\bInfer<typeof\\s+(\\w+)>/g, 'z.infer<typeof $1>');\n\n    return text;\n  }\n\n  private escapeRegex(str: string): string {\n    return str.replace(/[.*+?^${}()|[\\]\\\\]/g, '\\\\$&');\n  }\n}\n","import type { TransformHandler, TransformOptions, TransformResult } from '@schemashift/core';\nimport type { SourceFile } from 'ts-morph';\nimport { SuperstructToZodTransformer } from './superstruct-to-zod-transformer.js';\n\nexport function createSuperstructToZodHandler(): TransformHandler {\n  return {\n    transform(sourceFile: SourceFile, _options: TransformOptions): TransformResult {\n      const transformer = new SuperstructToZodTransformer();\n      return transformer.transform(sourceFile);\n    },\n  };\n}\n","import type { TransformError, TransformResult } from '@schemashift/core';\nimport type { SourceFile } from 'ts-morph';\nimport {\n  MANUAL_REVIEW_PATTERNS,\n  ZOD_TO_SUPERSTRUCT_FACTORIES,\n  ZOD_VALIDATION_TO_SUPERSTRUCT,\n} from './mappings.js';\n\n/**\n * Zod → Superstruct Transformer\n *\n * Converts Zod schemas to Superstruct structs.\n * Superstruct uses a function-based API without a namespace prefix:\n *   Zod:         z.object({ name: z.string().email() })\n *   Superstruct: object({ name: refine(string(), \"email\", ...) })\n */\nexport class ZodToSuperstructTransformer {\n  private errors: TransformError[] = [];\n  private warnings: string[] = [];\n  private usedImports = new Set<string>();\n\n  transform(sourceFile: SourceFile): TransformResult {\n    this.errors = [];\n    this.warnings = [];\n    this.usedImports = new Set();\n\n    const filePath = sourceFile.getFilePath();\n    const originalCode = sourceFile.getFullText();\n\n    try {\n      let text = originalCode;\n\n      // Step 1: Transform schema definitions (before import rewriting to detect needed imports)\n      text = this.transformSchemas(text, filePath);\n\n      // Step 2: Transform type helpers\n      text = this.transformTypeHelpers(text);\n\n      // Step 3: Rewrite imports (after transforms, so we know which imports to add)\n      text = this.rewriteImports(text);\n\n      // Step 4: Check for manual review patterns\n      this.checkManualReviewPatterns(text, filePath);\n\n      sourceFile.replaceWithText(text);\n\n      return {\n        success: this.errors.length === 0,\n        filePath,\n        originalCode,\n        transformedCode: sourceFile.getFullText(),\n        errors: this.errors,\n        warnings: this.warnings,\n      };\n    } catch (error) {\n      this.errors.push({\n        message: error instanceof Error ? error.message : 'Unknown error',\n      });\n      return {\n        success: false,\n        filePath,\n        originalCode,\n        errors: this.errors,\n        warnings: this.warnings,\n      };\n    }\n  }\n\n  private rewriteImports(text: string): string {\n    // Collect all superstruct functions used\n    const imports = [...this.usedImports].sort();\n\n    // Replace zod import with superstruct import\n    text = text.replace(\n      /import\\s*\\{[^}]*\\bz\\b[^}]*\\}\\s*from\\s*['\"]zod['\"]/g,\n      `import { ${imports.join(', ')} } from 'superstruct'`,\n    );\n\n    // Handle namespace import\n    text = text.replace(\n      /import\\s*\\*\\s*as\\s*z\\s*from\\s*['\"]zod['\"]/g,\n      `import { ${imports.join(', ')} } from 'superstruct'`,\n    );\n\n    // Handle type imports\n    text = text.replace(\n      /import\\s+type\\s*\\{[^}]*\\}\\s*from\\s*['\"]zod['\"]/g,\n      `import type { Infer } from 'superstruct'`,\n    );\n\n    return text;\n  }\n\n  private transformSchemas(text: string, filePath: string): string {\n    // Transform simple factories\n    for (const [zodFactory, ssFactory] of Object.entries(ZOD_TO_SUPERSTRUCT_FACTORIES)) {\n      if (text.includes(zodFactory)) {\n        text = text.replace(new RegExp(this.escapeRegex(zodFactory), 'g'), ssFactory);\n        // Track imports needed\n        const fnName = ssFactory.match(/^(\\w+)\\(/)?.[1];\n        if (fnName) this.usedImports.add(fnName);\n      }\n    }\n\n    // Transform z.object({...}) → object({...})\n    text = text.replace(/\\bz\\.object\\(/g, 'object(');\n    this.usedImports.add('object');\n\n    // Transform z.array(X) → array(X)\n    text = text.replace(/\\bz\\.array\\(/g, 'array(');\n    this.usedImports.add('array');\n\n    // Transform .optional() → optional(X)\n    // This requires wrapping: X.optional() → optional(X)\n    text = text.replace(/(\\w+\\([^)]*\\))\\.optional\\(\\)/g, 'optional($1)');\n    this.usedImports.add('optional');\n\n    // Transform .nullable() → nullable(X)\n    text = text.replace(/(\\w+\\([^)]*\\))\\.nullable\\(\\)/g, 'nullable($1)');\n    this.usedImports.add('nullable');\n\n    // Transform z.enum([\"a\", \"b\"]) → enums([\"a\", \"b\"])\n    text = text.replace(/\\bz\\.enum\\(/g, 'enums(');\n    this.usedImports.add('enums');\n\n    // Transform z.literal(X) → literal(X)\n    text = text.replace(/\\bz\\.literal\\(/g, 'literal(');\n    this.usedImports.add('literal');\n\n    // Transform z.union([...]) → union([...])\n    text = text.replace(/\\bz\\.union\\(/g, 'union(');\n    this.usedImports.add('union');\n\n    // Transform z.record(k, v) → record(k, v)\n    text = text.replace(/\\bz\\.record\\(/g, 'record(');\n    this.usedImports.add('record');\n\n    // Transform z.tuple([...]) → tuple([...])\n    text = text.replace(/\\bz\\.tuple\\(/g, 'tuple(');\n    this.usedImports.add('tuple');\n\n    // Transform string validations\n    for (const [zodMethod, ssReplacement] of Object.entries(ZOD_VALIDATION_TO_SUPERSTRUCT)) {\n      const pattern = new RegExp(`string\\\\(\\\\)\\\\.${zodMethod}\\\\(\\\\)`, 'g');\n      if (pattern.test(text)) {\n        text = text.replace(\n          pattern,\n          `${ssReplacement.startsWith('pattern') ? ssReplacement.replace('pattern(', 'pattern(string(), ') : ssReplacement.replace('refine(', 'refine(string(), ')}`,\n        );\n        const fnName = ssReplacement.match(/^(\\w+)\\(/)?.[1];\n        if (fnName) this.usedImports.add(fnName);\n        this.usedImports.add('string');\n      }\n    }\n\n    // Transform .min()/.max()/.length() on strings\n    text = text.replace(/string\\(\\)\\.min\\((\\d+)\\)/g, (_m, n) => {\n      this.usedImports.add('size');\n      this.usedImports.add('string');\n      return `size(string(), ${n}, Infinity)`;\n    });\n    text = text.replace(/string\\(\\)\\.max\\((\\d+)\\)/g, (_m, n) => {\n      this.usedImports.add('size');\n      this.usedImports.add('string');\n      return `size(string(), 0, ${n})`;\n    });\n\n    // Transform z.number().int() → integer()\n    text = text.replace(/number\\(\\)\\.int\\(\\)/g, 'integer()');\n    this.usedImports.add('integer');\n\n    // Transform .refine() → refine()\n    text = text.replace(/(\\w+\\([^)]*\\))\\.refine\\(([^)]+)\\)/g, (_m, schema, fn) => {\n      this.usedImports.add('refine');\n      return `refine(${schema}, \"custom\", ${fn})`;\n    });\n\n    // Check for remaining z.* patterns\n    if (/\\bz\\./.test(text)) {\n      this.warnings.push(\n        `${filePath}: Some Zod patterns could not be auto-transformed to Superstruct. ` +\n          'Look for remaining z.* references and convert manually.',\n      );\n    }\n\n    return text;\n  }\n\n  private transformTypeHelpers(text: string): string {\n    // z.infer<typeof schema> → Infer<typeof schema>\n    text = text.replace(/z\\.infer<typeof\\s+(\\w+)>/g, 'Infer<typeof $1>');\n    text = text.replace(/z\\.input<typeof\\s+(\\w+)>/g, 'Infer<typeof $1>');\n    text = text.replace(/z\\.output<typeof\\s+(\\w+)>/g, 'Infer<typeof $1>');\n\n    return text;\n  }\n\n  private checkManualReviewPatterns(text: string, filePath: string): void {\n    for (const pattern of MANUAL_REVIEW_PATTERNS) {\n      if (text.includes(`.${pattern}(`) || text.includes(`z.${pattern}(`)) {\n        const guidance = this.getManualGuidance(pattern);\n        this.warnings.push(\n          `${filePath}: .${pattern}() requires manual conversion to Superstruct. ${guidance}`,\n        );\n      }\n    }\n  }\n\n  private getManualGuidance(pattern: string): string {\n    const guidance: Record<string, string> = {\n      discriminatedUnion:\n        'Superstruct has no discriminatedUnion. Use union() with explicit struct variants.',\n      superRefine: 'Use define() for custom validation: define(\"name\", (value) => { ... }).',\n      transform: 'Use coerce() for transforms: coerce(target, source, (value) => transformed).',\n      preprocess:\n        'Use coerce() for preprocessing: coerce(target, source, (value) => preprocessed).',\n      lazy: 'Use lazy() from superstruct for recursive types: lazy(() => myStruct).',\n      brand: 'Superstruct has no brand() equivalent. Use define() with a branded type.',\n      catch: 'Superstruct has no catch() equivalent. Handle defaults at the application level.',\n      pipe: 'Superstruct has no pipe() equivalent. Use coerce() or define() instead.',\n    };\n    return guidance[pattern] || 'See Superstruct documentation for equivalent pattern.';\n  }\n\n  private escapeRegex(str: string): string {\n    return str.replace(/[.*+?^${}()|[\\]\\\\]/g, '\\\\$&');\n  }\n}\n","import type { TransformHandler, TransformOptions, TransformResult } from '@schemashift/core';\nimport type { SourceFile } from 'ts-morph';\nimport { ZodToSuperstructTransformer } from './zod-to-superstruct-transformer.js';\n\nexport function createZodToSuperstructHandler(): TransformHandler {\n  return {\n    transform(sourceFile: SourceFile, _options: TransformOptions): TransformResult {\n      const transformer = new ZodToSuperstructTransformer();\n      return transformer.transform(sourceFile);\n    },\n  };\n}\n"],"mappings":"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","names":[]}

package/package.json

@@ -0,0 +1,48 @@
+{
+  "name": "@schemashift/zod-superstruct",
+  "version": "0.10.0",
+  "description": "Zod ↔ Superstruct transformer for SchemaShift",
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.js"
+      },
+      "require": {
+        "types": "./dist/index.d.cts",
+        "default": "./dist/index.cjs"
+      }
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsup",
+    "test": "vitest run",
+    "typecheck": "tsc --noEmit"
+  },
+  "keywords": [
+    "schemashift",
+    "zod",
+    "superstruct",
+    "migration",
+    "codemod"
+  ],
+  "author": "Joseph May",
+  "license": "MIT",
+  "engines": {
+    "node": ">=22.0.0"
+  },
+  "dependencies": {
+    "@schemashift/core": "0.10.0",
+    "ts-morph": "27.0.2"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}