@sdk-it/typescript 0.37.1 → 0.39.0

package/dist/src/lib/emitters/interface.js

@@ -0,0 +1,169 @@
+import { followRef, isRef, parseRef, pascalcase } from "@sdk-it/core";
+import { isPrimitiveSchema, sanitizeTag } from "@sdk-it/spec";
+class TypeScriptEmitter {
+  #spec;
+  constructor(spec) {
+    this.#spec = spec;
+  }
+  #stringifyKey = (value) => {
+    return `'${value}'`;
+  };
+  object(schema, required = false) {
+    const properties = schema.properties || {};
+    const propEntries = Object.entries(properties).map(([key, propSchema]) => {
+      const isRequired = (schema.required ?? []).includes(key);
+      const tsType = this.handle(propSchema, isRequired);
+      return `${this.#stringifyKey(key)}: ${tsType}`;
+    });
+    if (schema.additionalProperties) {
+      if (typeof schema.additionalProperties === "object") {
+        const indexType = this.handle(schema.additionalProperties, true);
+        propEntries.push(`[key: string]: ${indexType}`);
+      } else if (schema.additionalProperties === true) {
+        propEntries.push("[key: string]: any");
+      }
+    }
+    return `${propEntries.length ? `{ ${propEntries.join("; ")} }` : "unknown"}`;
+  }
+  /**
+   * Handle arrays (items could be a single schema or a tuple)
+   */
+  #array(schema, required = false) {
+    const { items } = schema;
+    if (!items) {
+      return "any[]";
+    }
+    if (Array.isArray(items)) {
+      const tupleItems = items.map((sub) => this.handle(sub, true));
+      return `[${tupleItems.join(", ")}]`;
+    }
+    const itemsType = this.handle(items, true);
+    return itemsType.length > 1 ? `(${itemsType})[]` : `${itemsType}[]`;
+  }
+  /**
+   * Convert a basic type (string | number | boolean | object | array, etc.) to TypeScript
+   */
+  normal(type, schema, required = false) {
+    switch (type) {
+      case "string":
+        return this.string(schema, required);
+      case "number":
+      case "integer":
+        return this.number(schema, required);
+      case "boolean":
+        return appendOptional("boolean", required);
+      case "object":
+        return this.object(schema, required);
+      case "array":
+        return this.#array(schema, required);
+      case "null":
+        return "null";
+      default:
+        console.warn(`Unknown type: ${type}`);
+        return appendOptional("any", required);
+    }
+  }
+  #ref($ref, required) {
+    const schemaName = pascalcase(sanitizeTag(parseRef($ref).model));
+    const schema = followRef(this.#spec, $ref);
+    if (isPrimitiveSchema(schema)) {
+      return this.handle(schema, required);
+    }
+    return `models.${appendOptional(schemaName, required)}`;
+  }
+  allOf(schemas) {
+    const allOfTypes = schemas.map((sub) => this.handle(sub, true));
+    return allOfTypes.length > 1 ? `${allOfTypes.join(" & ")}` : allOfTypes[0];
+  }
+  oneOf(schemas, required) {
+    const oneOfTypes = schemas.map((sub) => this.handle(sub, true));
+    return appendOptional(
+      oneOfTypes.length > 1 ? `${oneOfTypes.join(" | ")}` : oneOfTypes[0],
+      required
+    );
+  }
+  anyOf(schemas, required) {
+    return this.oneOf(schemas, required);
+  }
+  enum(values, required) {
+    const enumValues = values.map((val) => typeof val === "string" ? `'${val}'` : `${val}`).join(" | ");
+    return appendOptional(enumValues, required);
+  }
+  /**
+   * Handle string type with formats
+   */
+  string(schema, required) {
+    let type;
+    if (schema.contentEncoding === "binary") {
+      return appendOptional("Blob", required);
+    }
+    switch (schema.format) {
+      case "date-time":
+      case "datetime":
+      case "date":
+        type = "Date";
+        break;
+      case "binary":
+      case "byte":
+        type = "Blob";
+        break;
+      case "int64":
+        type = "bigint";
+        break;
+      default:
+        type = "string";
+    }
+    return appendOptional(type, required);
+  }
+  /**
+   * Handle number/integer types with formats
+   */
+  number(schema, required) {
+    const type = schema.format === "int64" ? "bigint" : "number";
+    return appendOptional(type, required);
+  }
+  handle(schema, required) {
+    if (isRef(schema)) {
+      return this.#ref(schema.$ref, required);
+    }
+    if (schema.allOf && Array.isArray(schema.allOf)) {
+      return this.allOf(schema.allOf);
+    }
+    if (schema.anyOf && Array.isArray(schema.anyOf)) {
+      return this.anyOf(schema.anyOf, required);
+    }
+    if (schema.oneOf && Array.isArray(schema.oneOf)) {
+      return this.oneOf(schema.oneOf, required);
+    }
+    if (schema.enum && Array.isArray(schema.enum)) {
+      return this.enum(schema.enum, required);
+    }
+    if (schema.const) {
+      return this.enum([schema.const], true);
+    }
+    const types = Array.isArray(schema.type) ? schema.type : schema.type ? [schema.type] : [];
+    if (!types.length) {
+      if ("properties" in schema) {
+        return this.object(schema, required);
+      }
+      return appendOptional("any", required);
+    }
+    if (types.length > 1) {
+      const realTypes = types.filter((t) => t !== "null");
+      if (realTypes.length === 1 && types.includes("null")) {
+        const tsType = this.normal(realTypes[0], schema, false);
+        return appendOptional(`${tsType} | null`, required);
+      }
+      const typeResults = types.map((t) => this.normal(t, schema, false));
+      return appendOptional(typeResults.join(" | "), required);
+    }
+    return this.normal(types[0], schema, required);
+  }
+}
+function appendOptional(type, isRequired) {
+  return isRequired ? type : `${type} | undefined`;
+}
+export {
+  TypeScriptEmitter
+};
+//# sourceMappingURL=interface.js.map

package/dist/src/lib/emitters/interface.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/lib/emitters/interface.ts"],
+  "sourcesContent": ["import type {\n  ReferenceObject,\n  SchemaObject\n} from 'openapi3-ts/oas31';\n\nimport { followRef, isRef, parseRef, pascalcase } from '@sdk-it/core';\nimport { type IR, isPrimitiveSchema, sanitizeTag } from '@sdk-it/spec';\n\nexport class TypeScriptEmitter {\n  #spec: IR;\n\n  constructor(spec: IR) {\n    this.#spec = spec;\n  }\n  #stringifyKey = (value: string): string => {\n    return `'${value}'`;\n  };\n\n  object(schema: SchemaObject, required = false): string {\n    const properties = schema.properties || {};\n\n    const propEntries = Object.entries(properties).map(([key, propSchema]) => {\n      const isRequired = (schema.required ?? []).includes(key);\n      const tsType = this.handle(propSchema, isRequired);\n      return `${this.#stringifyKey(key)}: ${tsType}`;\n    });\n\n    if (schema.additionalProperties) {\n      if (typeof schema.additionalProperties === 'object') {\n        const indexType = this.handle(schema.additionalProperties, true);\n        propEntries.push(`[key: string]: ${indexType}`);\n      } else if (schema.additionalProperties === true) {\n        propEntries.push('[key: string]: any');\n      }\n    }\n\n    return `${propEntries.length ? `{ ${propEntries.join('; ')} }` : 'unknown'}`;\n  }\n\n  /**\n   * Handle arrays (items could be a single schema or a tuple)\n   */\n  #array(schema: SchemaObject, required = false): string {\n    const { items } = schema;\n    if (!items) {\n      // No items => any[]\n      return 'any[]';\n    }\n\n    // If items is an array => tuple\n    if (Array.isArray(items)) {\n      const tupleItems = items.map((sub) => this.handle(sub, true));\n      return `[${tupleItems.join(', ')}]`;\n    }\n\n    // If items is a single schema => standard array\n    const itemsType = this.handle(items, true);\n    return itemsType.length > 1 ? `(${itemsType})[]` : `${itemsType}[]`;\n  }\n\n  /**\n   * Convert a basic type (string | number | boolean | object | array, etc.) to TypeScript\n   */\n  normal(type: string, schema: SchemaObject, required = false): string {\n    switch (type) {\n      case 'string':\n        return this.string(schema, required);\n      case 'number':\n      case 'integer':\n        return this.number(schema, required);\n      case 'boolean':\n        return appendOptional('boolean', required);\n      case 'object':\n        return this.object(schema, required);\n      case 'array':\n        return this.#array(schema, required);\n      case 'null':\n        return 'null';\n      default:\n        console.warn(`Unknown type: ${type}`);\n        // Unknown type -> fallback\n        return appendOptional('any', required);\n    }\n  }\n\n  #ref($ref: string, required: boolean): string {\n    const schemaName = pascalcase(sanitizeTag(parseRef($ref).model));\n    const schema = followRef(this.#spec, $ref);\n    if (isPrimitiveSchema(schema)) {\n      return this.handle(schema, required);\n    }\n\n    return `models.${appendOptional(schemaName, required)}`;\n  }\n\n  allOf(schemas: (SchemaObject | ReferenceObject)[]): string {\n    // For TypeScript we use intersection types for allOf\n    const allOfTypes = schemas.map((sub) => this.handle(sub, true));\n    return allOfTypes.length > 1 ? `${allOfTypes.join(' & ')}` : allOfTypes[0];\n  }\n\n  oneOf(\n    schemas: (SchemaObject | ReferenceObject)[],\n    required: boolean,\n  ): string {\n    // For TypeScript we use union types for anyOf/oneOf\n    const oneOfTypes = schemas.map((sub) => this.handle(sub, true));\n    return appendOptional(\n      oneOfTypes.length > 1 ? `${oneOfTypes.join(' | ')}` : oneOfTypes[0],\n      required,\n    );\n  }\n  anyOf(\n    schemas: (SchemaObject | ReferenceObject)[],\n    required: boolean,\n  ): string {\n    return this.oneOf(schemas, required);\n  }\n\n  enum(values: unknown[], required: boolean): string {\n    // For TypeScript enums as union of literals\n    const enumValues = values\n      .map((val) => (typeof val === 'string' ? `'${val}'` : `${val}`))\n      .join(' | ');\n    return appendOptional(enumValues, required);\n  }\n\n  /**\n   * Handle string type with formats\n   */\n  string(schema: SchemaObject, required?: boolean): string {\n    let type: string;\n\n    if (schema.contentEncoding === 'binary') {\n      return appendOptional('Blob', required);\n    }\n\n    switch (schema.format) {\n      case 'date-time':\n      case 'datetime':\n      case 'date':\n        type = 'Date';\n        break;\n      case 'binary':\n      case 'byte':\n        type = 'Blob';\n        break;\n      case 'int64':\n        type = 'bigint';\n        break;\n      default:\n        type = 'string';\n    }\n\n    return appendOptional(type, required);\n  }\n\n  /**\n   * Handle number/integer types with formats\n   */\n  number(schema: SchemaObject, required?: boolean): string {\n    const type = schema.format === 'int64' ? 'bigint' : 'number';\n    return appendOptional(type, required);\n  }\n\n  handle(schema: SchemaObject | ReferenceObject, required: boolean): string {\n    if (isRef(schema)) {\n      return this.#ref(schema.$ref, required);\n    }\n\n    // Handle allOf (intersection in TypeScript)\n    if (schema.allOf && Array.isArray(schema.allOf)) {\n      return this.allOf(schema.allOf);\n    }\n\n    // anyOf (union in TypeScript)\n    if (schema.anyOf && Array.isArray(schema.anyOf)) {\n      return this.anyOf(schema.anyOf, required);\n    }\n\n    // oneOf (union in TypeScript)\n    if (schema.oneOf && Array.isArray(schema.oneOf)) {\n      return this.oneOf(schema.oneOf, required);\n    }\n\n    // enum\n    if (schema.enum && Array.isArray(schema.enum)) {\n      return this.enum(schema.enum, required);\n    }\n\n    if (schema.const) {\n      return this.enum([schema.const], true);\n    }\n\n    // Handle types, in TypeScript we can have union types directly\n    const types = Array.isArray(schema.type)\n      ? schema.type\n      : schema.type\n        ? [schema.type]\n        : [];\n\n    // If no explicit \"type\", fallback to any\n    if (!types.length) {\n      // unless properties are defined then assume object\n      if ('properties' in schema) {\n        return this.object(schema, required);\n      }\n      return appendOptional('any', required);\n    }\n\n    // Handle union types (multiple types)\n    if (types.length > 1) {\n      const realTypes = types.filter((t) => t !== 'null');\n      if (realTypes.length === 1 && types.includes('null')) {\n        // Single real type + \"null\"\n        const tsType = this.normal(realTypes[0], schema, false);\n        return appendOptional(`${tsType} | null`, required);\n      }\n\n      // Multiple different types\n      const typeResults = types.map((t) => this.normal(t, schema, false));\n      return appendOptional(typeResults.join(' | '), required);\n    }\n\n    // Single type\n    return this.normal(types[0], schema, required);\n  }\n}\n\nfunction appendOptional(type: string, isRequired?: boolean): string {\n  return isRequired ? type : `${type} | undefined`;\n}\n"],
+  "mappings": "AAKA,SAAS,WAAW,OAAO,UAAU,kBAAkB;AACvD,SAAkB,mBAAmB,mBAAmB;AAEjD,MAAM,kBAAkB;AAAA,EAC7B;AAAA,EAEA,YAAY,MAAU;AACpB,SAAK,QAAQ;AAAA,EACf;AAAA,EACA,gBAAgB,CAAC,UAA0B;AACzC,WAAO,IAAI,KAAK;AAAA,EAClB;AAAA,EAEA,OAAO,QAAsB,WAAW,OAAe;AACrD,UAAM,aAAa,OAAO,cAAc,CAAC;AAEzC,UAAM,cAAc,OAAO,QAAQ,UAAU,EAAE,IAAI,CAAC,CAAC,KAAK,UAAU,MAAM;AACxE,YAAM,cAAc,OAAO,YAAY,CAAC,GAAG,SAAS,GAAG;AACvD,YAAM,SAAS,KAAK,OAAO,YAAY,UAAU;AACjD,aAAO,GAAG,KAAK,cAAc,GAAG,CAAC,KAAK,MAAM;AAAA,IAC9C,CAAC;AAED,QAAI,OAAO,sBAAsB;AAC/B,UAAI,OAAO,OAAO,yBAAyB,UAAU;AACnD,cAAM,YAAY,KAAK,OAAO,OAAO,sBAAsB,IAAI;AAC/D,oBAAY,KAAK,kBAAkB,SAAS,EAAE;AAAA,MAChD,WAAW,OAAO,yBAAyB,MAAM;AAC/C,oBAAY,KAAK,oBAAoB;AAAA,MACvC;AAAA,IACF;AAEA,WAAO,GAAG,YAAY,SAAS,KAAK,YAAY,KAAK,IAAI,CAAC,OAAO,SAAS;AAAA,EAC5E;AAAA;AAAA;AAAA;AAAA,EAKA,OAAO,QAAsB,WAAW,OAAe;AACrD,UAAM,EAAE,MAAM,IAAI;AAClB,QAAI,CAAC,OAAO;AAEV,aAAO;AAAA,IACT;AAGA,QAAI,MAAM,QAAQ,KAAK,GAAG;AACxB,YAAM,aAAa,MAAM,IAAI,CAAC,QAAQ,KAAK,OAAO,KAAK,IAAI,CAAC;AAC5D,aAAO,IAAI,WAAW,KAAK,IAAI,CAAC;AAAA,IAClC;AAGA,UAAM,YAAY,KAAK,OAAO,OAAO,IAAI;AACzC,WAAO,UAAU,SAAS,IAAI,IAAI,SAAS,QAAQ,GAAG,SAAS;AAAA,EACjE;AAAA;AAAA;AAAA;AAAA,EAKA,OAAO,MAAc,QAAsB,WAAW,OAAe;AACnE,YAAQ,MAAM;AAAA,MACZ,KAAK;AACH,eAAO,KAAK,OAAO,QAAQ,QAAQ;AAAA,MACrC,KAAK;AAAA,MACL,KAAK;AACH,eAAO,KAAK,OAAO,QAAQ,QAAQ;AAAA,MACrC,KAAK;AACH,eAAO,eAAe,WAAW,QAAQ;AAAA,MAC3C,KAAK;AACH,eAAO,KAAK,OAAO,QAAQ,QAAQ;AAAA,MACrC,KAAK;AACH,eAAO,KAAK,OAAO,QAAQ,QAAQ;AAAA,MACrC,KAAK;AACH,eAAO;AAAA,MACT;AACE,gBAAQ,KAAK,iBAAiB,IAAI,EAAE;AAEpC,eAAO,eAAe,OAAO,QAAQ;AAAA,IACzC;AAAA,EACF;AAAA,EAEA,KAAK,MAAc,UAA2B;AAC5C,UAAM,aAAa,WAAW,YAAY,SAAS,IAAI,EAAE,KAAK,CAAC;AAC/D,UAAM,SAAS,UAAU,KAAK,OAAO,IAAI;AACzC,QAAI,kBAAkB,MAAM,GAAG;AAC7B,aAAO,KAAK,OAAO,QAAQ,QAAQ;AAAA,IACrC;AAEA,WAAO,UAAU,eAAe,YAAY,QAAQ,CAAC;AAAA,EACvD;AAAA,EAEA,MAAM,SAAqD;AAEzD,UAAM,aAAa,QAAQ,IAAI,CAAC,QAAQ,KAAK,OAAO,KAAK,IAAI,CAAC;AAC9D,WAAO,WAAW,SAAS,IAAI,GAAG,WAAW,KAAK,KAAK,CAAC,KAAK,WAAW,CAAC;AAAA,EAC3E;AAAA,EAEA,MACE,SACA,UACQ;AAER,UAAM,aAAa,QAAQ,IAAI,CAAC,QAAQ,KAAK,OAAO,KAAK,IAAI,CAAC;AAC9D,WAAO;AAAA,MACL,WAAW,SAAS,IAAI,GAAG,WAAW,KAAK,KAAK,CAAC,KAAK,WAAW,CAAC;AAAA,MAClE;AAAA,IACF;AAAA,EACF;AAAA,EACA,MACE,SACA,UACQ;AACR,WAAO,KAAK,MAAM,SAAS,QAAQ;AAAA,EACrC;AAAA,EAEA,KAAK,QAAmB,UAA2B;AAEjD,UAAM,aAAa,OAChB,IAAI,CAAC,QAAS,OAAO,QAAQ,WAAW,IAAI,GAAG,MAAM,GAAG,GAAG,EAAG,EAC9D,KAAK,KAAK;AACb,WAAO,eAAe,YAAY,QAAQ;AAAA,EAC5C;AAAA;AAAA;AAAA;AAAA,EAKA,OAAO,QAAsB,UAA4B;AACvD,QAAI;AAEJ,QAAI,OAAO,oBAAoB,UAAU;AACvC,aAAO,eAAe,QAAQ,QAAQ;AAAA,IACxC;AAEA,YAAQ,OAAO,QAAQ;AAAA,MACrB,KAAK;AAAA,MACL,KAAK;AAAA,MACL,KAAK;AACH,eAAO;AACP;AAAA,MACF,KAAK;AAAA,MACL,KAAK;AACH,eAAO;AACP;AAAA,MACF,KAAK;AACH,eAAO;AACP;AAAA,MACF;AACE,eAAO;AAAA,IACX;AAEA,WAAO,eAAe,MAAM,QAAQ;AAAA,EACtC;AAAA;AAAA;AAAA;AAAA,EAKA,OAAO,QAAsB,UAA4B;AACvD,UAAM,OAAO,OAAO,WAAW,UAAU,WAAW;AACpD,WAAO,eAAe,MAAM,QAAQ;AAAA,EACtC;AAAA,EAEA,OAAO,QAAwC,UAA2B;AACxE,QAAI,MAAM,MAAM,GAAG;AACjB,aAAO,KAAK,KAAK,OAAO,MAAM,QAAQ;AAAA,IACxC;AAGA,QAAI,OAAO,SAAS,MAAM,QAAQ,OAAO,KAAK,GAAG;AAC/C,aAAO,KAAK,MAAM,OAAO,KAAK;AAAA,IAChC;AAGA,QAAI,OAAO,SAAS,MAAM,QAAQ,OAAO,KAAK,GAAG;AAC/C,aAAO,KAAK,MAAM,OAAO,OAAO,QAAQ;AAAA,IAC1C;AAGA,QAAI,OAAO,SAAS,MAAM,QAAQ,OAAO,KAAK,GAAG;AAC/C,aAAO,KAAK,MAAM,OAAO,OAAO,QAAQ;AAAA,IAC1C;AAGA,QAAI,OAAO,QAAQ,MAAM,QAAQ,OAAO,IAAI,GAAG;AAC7C,aAAO,KAAK,KAAK,OAAO,MAAM,QAAQ;AAAA,IACxC;AAEA,QAAI,OAAO,OAAO;AAChB,aAAO,KAAK,KAAK,CAAC,OAAO,KAAK,GAAG,IAAI;AAAA,IACvC;AAGA,UAAM,QAAQ,MAAM,QAAQ,OAAO,IAAI,IACnC,OAAO,OACP,OAAO,OACL,CAAC,OAAO,IAAI,IACZ,CAAC;AAGP,QAAI,CAAC,MAAM,QAAQ;AAEjB,UAAI,gBAAgB,QAAQ;AAC1B,eAAO,KAAK,OAAO,QAAQ,QAAQ;AAAA,MACrC;AACA,aAAO,eAAe,OAAO,QAAQ;AAAA,IACvC;AAGA,QAAI,MAAM,SAAS,GAAG;AACpB,YAAM,YAAY,MAAM,OAAO,CAAC,MAAM,MAAM,MAAM;AAClD,UAAI,UAAU,WAAW,KAAK,MAAM,SAAS,MAAM,GAAG;AAEpD,cAAM,SAAS,KAAK,OAAO,UAAU,CAAC,GAAG,QAAQ,KAAK;AACtD,eAAO,eAAe,GAAG,MAAM,WAAW,QAAQ;AAAA,MACpD;AAGA,YAAM,cAAc,MAAM,IAAI,CAAC,MAAM,KAAK,OAAO,GAAG,QAAQ,KAAK,CAAC;AAClE,aAAO,eAAe,YAAY,KAAK,KAAK,GAAG,QAAQ;AAAA,IACzD;AAGA,WAAO,KAAK,OAAO,MAAM,CAAC,GAAG,QAAQ,QAAQ;AAAA,EAC/C;AACF;AAEA,SAAS,eAAe,MAAc,YAA8B;AAClE,SAAO,aAAa,OAAO,GAAG,IAAI;AACpC;",
+  "names": []
+}

package/dist/src/lib/emitters/snippet.js

@@ -0,0 +1,191 @@
+import { followRef, isRef, resolveRef } from "@sdk-it/core";
+class SnippetEmitter {
+  spec;
+  generatedRefs = /* @__PURE__ */ new Set();
+  cache = /* @__PURE__ */ new Map();
+  constructor(spec) {
+    this.spec = spec;
+  }
+  object(schema) {
+    const schemaObj = resolveRef(this.spec, schema);
+    const result = {};
+    const properties = schemaObj.properties || {};
+    for (const [propName, propSchema] of Object.entries(properties)) {
+      const isRequired = (schemaObj.required ?? []).includes(propName);
+      const resolvedProp = resolveRef(this.spec, propSchema);
+      if (isRequired || resolvedProp.example !== void 0 || resolvedProp.default !== void 0) {
+        result[propName] = this.handle(propSchema);
+      }
+    }
+    if (schemaObj.additionalProperties && typeof schemaObj.additionalProperties === "object") {
+      result["additionalPropExample"] = this.handle(
+        schemaObj.additionalProperties
+      );
+    }
+    return result;
+  }
+  array(schema) {
+    const schemaObj = resolveRef(this.spec, schema);
+    const itemsSchema = schemaObj.items;
+    if (!itemsSchema) {
+      return [];
+    }
+    const count = Math.min(schemaObj.minItems ?? 1, 2);
+    const result = [];
+    for (let i = 0; i < count; i++) {
+      result.push(this.handle(itemsSchema));
+    }
+    return result;
+  }
+  string(schema) {
+    if (schema.example !== void 0) return String(schema.example);
+    if (schema.default !== void 0) return String(schema.default);
+    switch (schema.format) {
+      case "date-time":
+      case "datetime":
+        return `2025-07-17T09:08:00.097Z`;
+      case "date":
+        return `2025-07-17`;
+      case "time":
+        return `09:08:00.097Z`;
+      case "email":
+        return "user@example.com";
+      case "uuid":
+        return "123e4567-e89b-12d3-a456-426614174000";
+      case "uri":
+      case "url":
+        return "https://example.com";
+      case "ipv4":
+        return "192.168.1.1";
+      case "ipv6":
+        return "2001:0db8:85a3:0000:0000:8a2e:0370:7334";
+      case "hostname":
+        return "example.com";
+      case "binary":
+      case "byte":
+        return `new Blob(['example'], { type: 'text/plain' })`;
+      default:
+        if (schema.enum && schema.enum.length > 0) {
+          return String(schema.enum[0]);
+        }
+        return schema.pattern ? `string matching ${schema.pattern}` : "example";
+    }
+  }
+  number(schema) {
+    if (schema.example !== void 0) return Number(schema.example);
+    if (schema.default !== void 0) return Number(schema.default);
+    let value;
+    if (typeof schema.exclusiveMinimum === "number") {
+      value = schema.exclusiveMinimum + 1;
+    } else if (typeof schema.minimum === "number") {
+      value = schema.minimum;
+    } else {
+      value = schema.type === "integer" ? 42 : 42.42;
+    }
+    if (typeof schema.exclusiveMaximum === "number" && value >= schema.exclusiveMaximum) {
+      value = schema.exclusiveMaximum - 1;
+    } else if (typeof schema.maximum === "number" && value > schema.maximum) {
+      value = schema.maximum;
+    }
+    if (typeof schema.multipleOf === "number" && value % schema.multipleOf !== 0) {
+      value = Math.floor(value / schema.multipleOf) * schema.multipleOf;
+    }
+    return schema.type === "integer" ? Math.floor(value) : value;
+  }
+  boolean(schema) {
+    if (schema.example !== void 0) return Boolean(schema.example);
+    if (schema.default !== void 0) return Boolean(schema.default);
+    return true;
+  }
+  null() {
+    return null;
+  }
+  ref($ref) {
+    const parts = $ref.split("/");
+    const refKey = parts[parts.length - 1] || "";
+    if (this.cache.has($ref)) {
+      return this.cache.get($ref);
+    }
+    this.cache.set($ref, { _ref: refKey });
+    const resolved = followRef(this.spec, $ref);
+    const result = this.handle(resolved);
+    this.cache.set($ref, result);
+    return result;
+  }
+  allOf(schemas) {
+    const initial = {};
+    return schemas.reduce((result, schema) => {
+      const example = this.handle(schema);
+      if (typeof example === "object" && example !== null) {
+        return { ...result, ...example };
+      }
+      return result;
+    }, initial);
+  }
+  anyOf(schemas) {
+    if (schemas.length === 0) return {};
+    return this.handle(schemas[0]);
+  }
+  oneOf(schemas) {
+    if (schemas.length === 0) return {};
+    return this.handle(schemas[0]);
+  }
+  enum(schema) {
+    return Array.isArray(schema.enum) && schema.enum.length > 0 ? schema.enum[0] : void 0;
+  }
+  handle(schemaOrRef) {
+    if (isRef(schemaOrRef)) {
+      return this.ref(schemaOrRef.$ref);
+    }
+    const schema = resolveRef(this.spec, schemaOrRef);
+    if (schema.example !== void 0) {
+      return schema.example;
+    }
+    if (schema.default !== void 0) {
+      return schema.default;
+    }
+    if (schema.allOf && Array.isArray(schema.allOf)) {
+      return this.allOf(schema.allOf);
+    }
+    if (schema.anyOf && Array.isArray(schema.anyOf)) {
+      return this.anyOf(schema.anyOf);
+    }
+    if (schema.oneOf && Array.isArray(schema.oneOf)) {
+      return this.oneOf(schema.oneOf);
+    }
+    if (schema.enum && Array.isArray(schema.enum) && schema.enum.length > 0) {
+      return this.enum(schema);
+    }
+    const types = Array.isArray(schema.type) ? schema.type : schema.type ? [schema.type] : [];
+    if (types.length === 0) {
+      if (schema.properties || schema.additionalProperties) {
+        return this.object(schema);
+      } else if (schema.items) {
+        return this.array(schema);
+      }
+      return "example";
+    }
+    const primaryType = types.find((t) => t !== "null") || types[0];
+    switch (primaryType) {
+      case "string":
+        return this.string(schema);
+      case "number":
+      case "integer":
+        return this.number(schema);
+      case "boolean":
+        return this.boolean(schema);
+      case "object":
+        return this.object(schema);
+      case "array":
+        return this.array(schema);
+      case "null":
+        return this.null();
+      default:
+        return "unknown";
+    }
+  }
+}
+export {
+  SnippetEmitter
+};
+//# sourceMappingURL=snippet.js.map

package/dist/src/lib/emitters/snippet.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/lib/emitters/snippet.ts"],
+  "sourcesContent": ["import type { ReferenceObject, SchemaObject } from 'openapi3-ts/oas31';\n\nimport { followRef, isRef, resolveRef } from '@sdk-it/core';\nimport type { IR } from '@sdk-it/spec';\n\n/**\n * Generate example values for OpenAPI schemas\n * This emitter creates sample input payloads for API documentation and code snippets\n */\nexport class SnippetEmitter {\n  private spec: IR;\n  public generatedRefs = new Set<string>();\n  private cache = new Map<string, unknown>();\n\n  constructor(spec: IR) {\n    this.spec = spec;\n  }\n\n  public object(\n    schema: SchemaObject | ReferenceObject,\n  ): Record<string, unknown> {\n    const schemaObj = resolveRef(this.spec, schema) as SchemaObject;\n    const result: Record<string, unknown> = {};\n    const properties = schemaObj.properties || {};\n\n    for (const [propName, propSchema] of Object.entries(properties)) {\n      const isRequired = (schemaObj.required ?? []).includes(propName);\n      const resolvedProp = resolveRef(this.spec, propSchema);\n\n      if (\n        isRequired ||\n        resolvedProp.example !== undefined ||\n        resolvedProp.default !== undefined\n      ) {\n        result[propName] = this.handle(propSchema);\n      }\n    }\n\n    if (\n      schemaObj.additionalProperties &&\n      typeof schemaObj.additionalProperties === 'object'\n    ) {\n      result['additionalPropExample'] = this.handle(\n        schemaObj.additionalProperties,\n      );\n    }\n\n    return result;\n  }\n\n  public array(schema: SchemaObject | ReferenceObject): unknown[] {\n    const schemaObj = resolveRef(this.spec, schema);\n    const itemsSchema = schemaObj.items;\n    if (!itemsSchema) {\n      return [];\n    }\n\n    const count = Math.min(schemaObj.minItems ?? 1, 2);\n    const result: unknown[] = [];\n\n    for (let i = 0; i < count; i++) {\n      result.push(this.handle(itemsSchema));\n    }\n\n    return result;\n  }\n\n  public string(schema: SchemaObject): string {\n    if (schema.example !== undefined) return String(schema.example);\n    if (schema.default !== undefined) return String(schema.default);\n\n    switch (schema.format) {\n      case 'date-time':\n      case 'datetime':\n        return `2025-07-17T09:08:00.097Z`;\n      case 'date':\n        return `2025-07-17`;\n      case 'time':\n        return `09:08:00.097Z`;\n      case 'email':\n        return 'user@example.com';\n      case 'uuid':\n        return '123e4567-e89b-12d3-a456-426614174000';\n      case 'uri':\n      case 'url':\n        return 'https://example.com';\n      case 'ipv4':\n        return '192.168.1.1';\n      case 'ipv6':\n        return '2001:0db8:85a3:0000:0000:8a2e:0370:7334';\n      case 'hostname':\n        return 'example.com';\n      case 'binary':\n      case 'byte':\n        return `new Blob(['example'], { type: 'text/plain' })`;\n      default:\n        if (schema.enum && schema.enum.length > 0) {\n          return String(schema.enum[0]);\n        }\n        return schema.pattern ? `string matching ${schema.pattern}` : 'example';\n    }\n  }\n\n  public number(schema: SchemaObject): number {\n    if (schema.example !== undefined) return Number(schema.example);\n    if (schema.default !== undefined) return Number(schema.default);\n\n    let value: number;\n    if (typeof schema.exclusiveMinimum === 'number') {\n      value = schema.exclusiveMinimum + 1;\n    } else if (typeof schema.minimum === 'number') {\n      value = schema.minimum;\n    } else {\n      value = schema.type === 'integer' ? 42 : 42.42;\n    }\n\n    if (\n      typeof schema.exclusiveMaximum === 'number' &&\n      value >= schema.exclusiveMaximum\n    ) {\n      value = schema.exclusiveMaximum - 1;\n    } else if (typeof schema.maximum === 'number' && value > schema.maximum) {\n      value = schema.maximum;\n    }\n\n    if (\n      typeof schema.multipleOf === 'number' &&\n      value % schema.multipleOf !== 0\n    ) {\n      value = Math.floor(value / schema.multipleOf) * schema.multipleOf;\n    }\n\n    return schema.type === 'integer' ? Math.floor(value) : value;\n  }\n\n  public boolean(schema: SchemaObject): boolean {\n    if (schema.example !== undefined) return Boolean(schema.example);\n    if (schema.default !== undefined) return Boolean(schema.default);\n    return true;\n  }\n\n  public null(): null {\n    return null;\n  }\n\n  public ref($ref: string): unknown {\n    const parts = $ref.split('/');\n    const refKey = parts[parts.length - 1] || '';\n\n    if (this.cache.has($ref)) {\n      return this.cache.get($ref) as unknown;\n    }\n\n    this.cache.set($ref, { _ref: refKey });\n\n    const resolved = followRef<SchemaObject>(this.spec, $ref);\n    const result = this.handle(resolved);\n\n    this.cache.set($ref, result);\n    return result;\n  }\n\n  public allOf(schemas: (SchemaObject | ReferenceObject)[]): unknown {\n    const initial: Record<string, unknown> = {};\n    return schemas.reduce<Record<string, unknown>>((result, schema) => {\n      const example = this.handle(schema);\n      if (typeof example === 'object' && example !== null) {\n        return { ...result, ...example };\n      }\n      return result;\n    }, initial);\n  }\n\n  public anyOf(schemas: (SchemaObject | ReferenceObject)[]): unknown {\n    if (schemas.length === 0) return {};\n    return this.handle(schemas[0]);\n  }\n\n  public oneOf(schemas: (SchemaObject | ReferenceObject)[]): unknown {\n    if (schemas.length === 0) return {};\n    return this.handle(schemas[0]);\n  }\n\n  public enum(schema: SchemaObject): unknown {\n    return Array.isArray(schema.enum) && schema.enum.length > 0\n      ? schema.enum[0]\n      : undefined;\n  }\n\n  public handle(schemaOrRef: SchemaObject | ReferenceObject): unknown {\n    if (isRef(schemaOrRef)) {\n      return this.ref(schemaOrRef.$ref);\n    }\n\n    const schema = resolveRef(this.spec, schemaOrRef);\n\n    if (schema.example !== undefined) {\n      return schema.example;\n    }\n\n    if (schema.default !== undefined) {\n      return schema.default;\n    }\n\n    if (schema.allOf && Array.isArray(schema.allOf)) {\n      return this.allOf(schema.allOf);\n    }\n    if (schema.anyOf && Array.isArray(schema.anyOf)) {\n      return this.anyOf(schema.anyOf);\n    }\n    if (schema.oneOf && Array.isArray(schema.oneOf)) {\n      return this.oneOf(schema.oneOf);\n    }\n\n    if (schema.enum && Array.isArray(schema.enum) && schema.enum.length > 0) {\n      return this.enum(schema);\n    }\n\n    const types = Array.isArray(schema.type)\n      ? schema.type\n      : schema.type\n        ? [schema.type]\n        : [];\n\n    if (types.length === 0) {\n      if (schema.properties || schema.additionalProperties) {\n        return this.object(schema);\n      } else if (schema.items) {\n        return this.array(schema);\n      }\n      return 'example';\n    }\n\n    const primaryType = types.find((t) => t !== 'null') || types[0];\n\n    switch (primaryType) {\n      case 'string':\n        return this.string(schema);\n      case 'number':\n      case 'integer':\n        return this.number(schema);\n      case 'boolean':\n        return this.boolean(schema);\n      case 'object':\n        return this.object(schema);\n      case 'array':\n        return this.array(schema);\n      case 'null':\n        return this.null();\n      default:\n        return 'unknown';\n    }\n  }\n}\n"],
+  "mappings": "AAEA,SAAS,WAAW,OAAO,kBAAkB;AAOtC,MAAM,eAAe;AAAA,EAClB;AAAA,EACD,gBAAgB,oBAAI,IAAY;AAAA,EAC/B,QAAQ,oBAAI,IAAqB;AAAA,EAEzC,YAAY,MAAU;AACpB,SAAK,OAAO;AAAA,EACd;AAAA,EAEO,OACL,QACyB;AACzB,UAAM,YAAY,WAAW,KAAK,MAAM,MAAM;AAC9C,UAAM,SAAkC,CAAC;AACzC,UAAM,aAAa,UAAU,cAAc,CAAC;AAE5C,eAAW,CAAC,UAAU,UAAU,KAAK,OAAO,QAAQ,UAAU,GAAG;AAC/D,YAAM,cAAc,UAAU,YAAY,CAAC,GAAG,SAAS,QAAQ;AAC/D,YAAM,eAAe,WAAW,KAAK,MAAM,UAAU;AAErD,UACE,cACA,aAAa,YAAY,UACzB,aAAa,YAAY,QACzB;AACA,eAAO,QAAQ,IAAI,KAAK,OAAO,UAAU;AAAA,MAC3C;AAAA,IACF;AAEA,QACE,UAAU,wBACV,OAAO,UAAU,yBAAyB,UAC1C;AACA,aAAO,uBAAuB,IAAI,KAAK;AAAA,QACrC,UAAU;AAAA,MACZ;AAAA,IACF;AAEA,WAAO;AAAA,EACT;AAAA,EAEO,MAAM,QAAmD;AAC9D,UAAM,YAAY,WAAW,KAAK,MAAM,MAAM;AAC9C,UAAM,cAAc,UAAU;AAC9B,QAAI,CAAC,aAAa;AAChB,aAAO,CAAC;AAAA,IACV;AAEA,UAAM,QAAQ,KAAK,IAAI,UAAU,YAAY,GAAG,CAAC;AACjD,UAAM,SAAoB,CAAC;AAE3B,aAAS,IAAI,GAAG,IAAI,OAAO,KAAK;AAC9B,aAAO,KAAK,KAAK,OAAO,WAAW,CAAC;AAAA,IACtC;AAEA,WAAO;AAAA,EACT;AAAA,EAEO,OAAO,QAA8B;AAC1C,QAAI,OAAO,YAAY,OAAW,QAAO,OAAO,OAAO,OAAO;AAC9D,QAAI,OAAO,YAAY,OAAW,QAAO,OAAO,OAAO,OAAO;AAE9D,YAAQ,OAAO,QAAQ;AAAA,MACrB,KAAK;AAAA,MACL,KAAK;AACH,eAAO;AAAA,MACT,KAAK;AACH,eAAO;AAAA,MACT,KAAK;AACH,eAAO;AAAA,MACT,KAAK;AACH,eAAO;AAAA,MACT,KAAK;AACH,eAAO;AAAA,MACT,KAAK;AAAA,MACL,KAAK;AACH,eAAO;AAAA,MACT,KAAK;AACH,eAAO;AAAA,MACT,KAAK;AACH,eAAO;AAAA,MACT,KAAK;AACH,eAAO;AAAA,MACT,KAAK;AAAA,MACL,KAAK;AACH,eAAO;AAAA,MACT;AACE,YAAI,OAAO,QAAQ,OAAO,KAAK,SAAS,GAAG;AACzC,iBAAO,OAAO,OAAO,KAAK,CAAC,CAAC;AAAA,QAC9B;AACA,eAAO,OAAO,UAAU,mBAAmB,OAAO,OAAO,KAAK;AAAA,IAClE;AAAA,EACF;AAAA,EAEO,OAAO,QAA8B;AAC1C,QAAI,OAAO,YAAY,OAAW,QAAO,OAAO,OAAO,OAAO;AAC9D,QAAI,OAAO,YAAY,OAAW,QAAO,OAAO,OAAO,OAAO;AAE9D,QAAI;AACJ,QAAI,OAAO,OAAO,qBAAqB,UAAU;AAC/C,cAAQ,OAAO,mBAAmB;AAAA,IACpC,WAAW,OAAO,OAAO,YAAY,UAAU;AAC7C,cAAQ,OAAO;AAAA,IACjB,OAAO;AACL,cAAQ,OAAO,SAAS,YAAY,KAAK;AAAA,IAC3C;AAEA,QACE,OAAO,OAAO,qBAAqB,YACnC,SAAS,OAAO,kBAChB;AACA,cAAQ,OAAO,mBAAmB;AAAA,IACpC,WAAW,OAAO,OAAO,YAAY,YAAY,QAAQ,OAAO,SAAS;AACvE,cAAQ,OAAO;AAAA,IACjB;AAEA,QACE,OAAO,OAAO,eAAe,YAC7B,QAAQ,OAAO,eAAe,GAC9B;AACA,cAAQ,KAAK,MAAM,QAAQ,OAAO,UAAU,IAAI,OAAO;AAAA,IACzD;AAEA,WAAO,OAAO,SAAS,YAAY,KAAK,MAAM,KAAK,IAAI;AAAA,EACzD;AAAA,EAEO,QAAQ,QAA+B;AAC5C,QAAI,OAAO,YAAY,OAAW,QAAO,QAAQ,OAAO,OAAO;AAC/D,QAAI,OAAO,YAAY,OAAW,QAAO,QAAQ,OAAO,OAAO;AAC/D,WAAO;AAAA,EACT;AAAA,EAEO,OAAa;AAClB,WAAO;AAAA,EACT;AAAA,EAEO,IAAI,MAAuB;AAChC,UAAM,QAAQ,KAAK,MAAM,GAAG;AAC5B,UAAM,SAAS,MAAM,MAAM,SAAS,CAAC,KAAK;AAE1C,QAAI,KAAK,MAAM,IAAI,IAAI,GAAG;AACxB,aAAO,KAAK,MAAM,IAAI,IAAI;AAAA,IAC5B;AAEA,SAAK,MAAM,IAAI,MAAM,EAAE,MAAM,OAAO,CAAC;AAErC,UAAM,WAAW,UAAwB,KAAK,MAAM,IAAI;AACxD,UAAM,SAAS,KAAK,OAAO,QAAQ;AAEnC,SAAK,MAAM,IAAI,MAAM,MAAM;AAC3B,WAAO;AAAA,EACT;AAAA,EAEO,MAAM,SAAsD;AACjE,UAAM,UAAmC,CAAC;AAC1C,WAAO,QAAQ,OAAgC,CAAC,QAAQ,WAAW;AACjE,YAAM,UAAU,KAAK,OAAO,MAAM;AAClC,UAAI,OAAO,YAAY,YAAY,YAAY,MAAM;AACnD,eAAO,EAAE,GAAG,QAAQ,GAAG,QAAQ;AAAA,MACjC;AACA,aAAO;AAAA,IACT,GAAG,OAAO;AAAA,EACZ;AAAA,EAEO,MAAM,SAAsD;AACjE,QAAI,QAAQ,WAAW,EAAG,QAAO,CAAC;AAClC,WAAO,KAAK,OAAO,QAAQ,CAAC,CAAC;AAAA,EAC/B;AAAA,EAEO,MAAM,SAAsD;AACjE,QAAI,QAAQ,WAAW,EAAG,QAAO,CAAC;AAClC,WAAO,KAAK,OAAO,QAAQ,CAAC,CAAC;AAAA,EAC/B;AAAA,EAEO,KAAK,QAA+B;AACzC,WAAO,MAAM,QAAQ,OAAO,IAAI,KAAK,OAAO,KAAK,SAAS,IACtD,OAAO,KAAK,CAAC,IACb;AAAA,EACN;AAAA,EAEO,OAAO,aAAsD;AAClE,QAAI,MAAM,WAAW,GAAG;AACtB,aAAO,KAAK,IAAI,YAAY,IAAI;AAAA,IAClC;AAEA,UAAM,SAAS,WAAW,KAAK,MAAM,WAAW;AAEhD,QAAI,OAAO,YAAY,QAAW;AAChC,aAAO,OAAO;AAAA,IAChB;AAEA,QAAI,OAAO,YAAY,QAAW;AAChC,aAAO,OAAO;AAAA,IAChB;AAEA,QAAI,OAAO,SAAS,MAAM,QAAQ,OAAO,KAAK,GAAG;AAC/C,aAAO,KAAK,MAAM,OAAO,KAAK;AAAA,IAChC;AACA,QAAI,OAAO,SAAS,MAAM,QAAQ,OAAO,KAAK,GAAG;AAC/C,aAAO,KAAK,MAAM,OAAO,KAAK;AAAA,IAChC;AACA,QAAI,OAAO,SAAS,MAAM,QAAQ,OAAO,KAAK,GAAG;AAC/C,aAAO,KAAK,MAAM,OAAO,KAAK;AAAA,IAChC;AAEA,QAAI,OAAO,QAAQ,MAAM,QAAQ,OAAO,IAAI,KAAK,OAAO,KAAK,SAAS,GAAG;AACvE,aAAO,KAAK,KAAK,MAAM;AAAA,IACzB;AAEA,UAAM,QAAQ,MAAM,QAAQ,OAAO,IAAI,IACnC,OAAO,OACP,OAAO,OACL,CAAC,OAAO,IAAI,IACZ,CAAC;AAEP,QAAI,MAAM,WAAW,GAAG;AACtB,UAAI,OAAO,cAAc,OAAO,sBAAsB;AACpD,eAAO,KAAK,OAAO,MAAM;AAAA,MAC3B,WAAW,OAAO,OAAO;AACvB,eAAO,KAAK,MAAM,MAAM;AAAA,MAC1B;AACA,aAAO;AAAA,IACT;AAEA,UAAM,cAAc,MAAM,KAAK,CAAC,MAAM,MAAM,MAAM,KAAK,MAAM,CAAC;AAE9D,YAAQ,aAAa;AAAA,MACnB,KAAK;AACH,eAAO,KAAK,OAAO,MAAM;AAAA,MAC3B,KAAK;AAAA,MACL,KAAK;AACH,eAAO,KAAK,OAAO,MAAM;AAAA,MAC3B,KAAK;AACH,eAAO,KAAK,QAAQ,MAAM;AAAA,MAC5B,KAAK;AACH,eAAO,KAAK,OAAO,MAAM;AAAA,MAC3B,KAAK;AACH,eAAO,KAAK,MAAM,MAAM;AAAA,MAC1B,KAAK;AACH,eAAO,KAAK,KAAK;AAAA,MACnB;AACE,eAAO;AAAA,IACX;AAAA,EACF;AACF;",
+  "names": []
+}