@azure-tools/typespec-autorest 0.42.0-dev.3 → 0.42.0-dev.5

package/dist/src/openapi.js

@@ -1,44 +1,14 @@
 import { extractLroStates, getArmResourceIdentifierConfig, getAsEmbeddingVector, getLroMetadata, getPagedResult, getUnionAsEnum, isFixed, } from "@azure-tools/typespec-azure-core";
-import { createSdkContext, getClientNameOverride, shouldFlattenProperty, } from "@azure-tools/typespec-client-generator-core";
-import { NoTarget, SyntaxKind, TwoLevelMap, compilerAssert, emitFile, getAllTags, getDirectoryPath, getDiscriminator, getDoc, getEncode, getFormat, getKnownValues, getMaxItems, getMaxLength, getMaxValue, getMinItems, getMinLength, getMinValue, getNamespaceFullName, getPattern, getProjectedName, getProperty, getPropertyType, getRelativePathFromDirectory, getRootLength, getService, getSummary, getVisibility, ignoreDiagnostics, interpolatePath, isArrayModelType, isDeprecated, isErrorModel, isErrorType, isGlobalNamespace, isNeverType, isNullType, isNumericType, isRecordModelType, isSecret, isService, isStringType, isTemplateDeclaration, isTemplateDeclarationOrInstance, isVoidType, listServices, navigateTypesInNamespace, projectProgram, resolveEncodedName, resolvePath, stringTemplateToString, } from "@typespec/compiler";
+import { shouldFlattenProperty } from "@azure-tools/typespec-client-generator-core";
+import { NoTarget, SyntaxKind, compilerAssert, createDiagnosticCollector, getAllTags, getDirectoryPath, getDiscriminator, getDoc, getEncode, getFormat, getKnownValues, getMaxItems, getMaxLength, getMaxValue, getMinItems, getMinLength, getMinValue, getPattern, getProjectedName, getProperty, getPropertyType, getRelativePathFromDirectory, getRootLength, getSummary, getVisibility, ignoreDiagnostics, interpolatePath, isArrayModelType, isDeprecated, isErrorModel, isErrorType, isGlobalNamespace, isNeverType, isNullType, isNumericType, isRecordModelType, isSecret, isService, isStringType, isTemplateDeclaration, isTemplateDeclarationOrInstance, isVoidType, navigateTypesInNamespace, resolveEncodedName, resolvePath, stringTemplateToString, } from "@typespec/compiler";
+import { TwoLevelMap } from "@typespec/compiler/utils";
 import { Visibility, createMetadataInfo, getAllHttpServices, getAuthentication, getHeaderFieldOptions, getQueryParamOptions, getServers, getStatusCodeDescription, getVisibilitySuffix, isContentTypeHeader, isSharedRoute, reportIfNoRoutes, resolveRequestVisibility, } from "@typespec/http";
 import { checkDuplicateTypeName, getExtensions, getExternalDocs, getOpenAPITypeName, getParameterKey, isReadonlyProperty, resolveInfo, shouldInline, } from "@typespec/openapi";
-import { buildVersionProjections } from "@typespec/versioning";
 import { AutorestOpenAPISchema } from "./autorest-openapi-schema.js";
 import { getExamples, getRef } from "./decorators.js";
 import { sortWithJsonSchema } from "./json-schema-sorter/sorter.js";
-import { getTracer, reportDiagnostic } from "./lib.js";
-import { resolveOperationId } from "./utils.js";
-const defaultOptions = {
-    "output-file": "{azure-resource-provider-folder}/{service-name}/{version-status}/{version}/openapi.json",
-    "new-line": "lf",
-    "include-x-typespec-name": "never",
-};
-export async function $onEmit(context) {
-    const resolvedOptions = { ...defaultOptions, ...context.options };
-    const tcgcSdkContext = createSdkContext(context, "@azure-tools/typespec-autorest");
-    const armTypesDir = interpolatePath(resolvedOptions["arm-types-dir"] ?? "{project-root}/../../common-types/resource-management", {
-        "project-root": context.program.projectRoot,
-        "emitter-output-dir": context.emitterOutputDir,
-    });
-    const options = {
-        outputFile: resolvedOptions["output-file"],
-        outputDir: context.emitterOutputDir,
-        azureResourceProviderFolder: resolvedOptions["azure-resource-provider-folder"],
-        examplesDirectory: resolvedOptions["examples-directory"],
-        version: resolvedOptions["version"],
-        newLine: resolvedOptions["new-line"],
-        omitUnreachableTypes: resolvedOptions["omit-unreachable-types"],
-        includeXTypeSpecName: resolvedOptions["include-x-typespec-name"],
-        armTypesDir,
-        useReadOnlyStatusSchema: resolvedOptions["use-read-only-status-schema"],
-    };
-    const emitter = createOAPIEmitter(context.program, tcgcSdkContext, options);
-    await emitter.emitOpenAPI();
-}
-function getEmitterDetails(program) {
-    return [{ emitter: "@azure-tools/typespec-autorest" }];
-}
+import { createDiagnostic, reportDiagnostic } from "./lib.js";
+import { getClientName, resolveOperationId } from "./utils.js";
 /**
  * Represents a node that will hold a JSON reference. The value is computed
  * at the end so that we can defer decisions about the name that is
@@ -51,113 +21,111 @@ class Ref {
         return this.value;
     }
 }
-function createOAPIEmitter(program, tcgcSdkContext, options) {
-    const tracer = getTracer(program);
-    tracer.trace("options", JSON.stringify(options, null, 2));
+export async function getOpenAPIForService(context, options) {
+    const { program, service } = context;
     const typeNameOptions = {
         // shorten type names by removing TypeSpec and service namespace
         namespaceFilter(ns) {
             return !isService(program, ns);
         },
     };
-    let root;
-    let currentService;
+    const info = resolveInfo(program, service.type);
+    const auth = processAuth(service.type);
+    const root = {
+        swagger: "2.0",
+        info: {
+            title: "(title)",
+            ...info,
+            version: context.version ?? info?.version ?? "0000-00-00",
+            "x-typespec-generated": [{ emitter: "@azure-tools/typespec-autorest" }],
+        },
+        schemes: ["https"],
+        ...resolveHost(program, service.type),
+        externalDocs: getExternalDocs(program, service.type),
+        produces: [], // Pre-initialize produces and consumes so that
+        consumes: [], // they show up at the top of the document
+        security: auth?.security,
+        securityDefinitions: auth?.securitySchemes ?? {},
+        tags: [],
+        paths: {},
+        "x-ms-paths": {},
+        definitions: {},
+        parameters: {},
+    };
     let currentEndpoint;
     let currentConsumes;
     let currentProduces;
-    let metadataInfo;
+    const metadataInfo = createMetadataInfo(program, {
+        canonicalVisibility: Visibility.Read,
+        canShareProperty: canSharePropertyUsingReadonlyOrXMSMutability,
+    });
     // Keep a map of all Types+Visibility combinations that were encountered
     // that need schema definitions.
-    let pendingSchemas = new TwoLevelMap();
+    const pendingSchemas = new TwoLevelMap();
     // Reuse a single ref object per Type+Visibility combination.
-    let refs = new TwoLevelMap();
+    const refs = new TwoLevelMap();
     // Keep track of inline types still in the process of having their schema computed
     // This is used to detect cycles in inline types, which is an
-    let inProgressInlineTypes = new Set();
+    const inProgressInlineTypes = new Set();
     // Map model properties that represent shared parameters to their parameter
     // definition that will go in #/parameters. Inlined parameters do not go in
     // this map.
-    let params;
+    const params = new Map();
     // Keep track of models that have had properties spread into parameters. We won't
     // consider these unreferenced when emitting unreferenced types.
-    let paramModels;
+    const paramModels = new Set();
     // De-dupe the per-endpoint tags that will be added into the #/tags
-    let tags;
+    const tags = new Set();
     // The set of produces/consumes values found in all operations
     const globalProduces = new Set(["application/json"]);
     const globalConsumes = new Set(["application/json"]);
-    let operationExamplesMap;
-    let operationIdsWithExample;
-    let outputFile;
-    let context;
-    async function emitOpenAPI() {
-        const services = listServices(program);
-        if (services.length === 0) {
-            services.push({ type: program.getGlobalNamespaceType() });
-        }
-        for (const service of services) {
-            currentService = service;
-            const originalProgram = program;
-            const versions = buildVersionProjections(program, service.type).filter((v) => !options.version || options.version === v.version);
-            for (const record of versions) {
-                let projectedProgram;
-                if (record.projections.length > 0) {
-                    projectedProgram = program = projectProgram(originalProgram, record.projections);
-                }
-                context = {
-                    program,
-                    service,
-                    version: record.version,
-                    getClientName,
-                };
-                const projectedServiceNs = projectedProgram
-                    ? projectedProgram.projector.projectedTypes.get(service.type)
-                    : service.type;
-                await emitOpenAPIFromVersion(projectedServiceNs === program.getGlobalNamespaceType()
-                    ? { type: program.getGlobalNamespaceType() }
-                    : getService(program, projectedServiceNs), services.length > 1, record.version);
-            }
-        }
-    }
-    return { emitOpenAPI };
-    function initializeEmitter(service, multipleService, version) {
-        const auth = processAuth(service.type);
-        const info = resolveInfo(program, service.type);
-        root = {
-            swagger: "2.0",
-            info: {
-                title: "(title)",
-                ...info,
-                version: version ?? info?.version ?? "0000-00-00",
-                "x-typespec-generated": getEmitterDetails(program),
-            },
-            schemes: ["https"],
-            ...resolveHost(program, service.type),
-            externalDocs: getExternalDocs(program, service.type),
-            produces: [], // Pre-initialize produces and consumes so that
-            consumes: [], // they show up at the top of the document
-            security: auth?.security,
-            securityDefinitions: auth?.securitySchemes ?? {},
-            tags: [],
-            paths: {},
-            "x-ms-paths": {},
-            definitions: {},
-            parameters: {},
-        };
-        pendingSchemas = new TwoLevelMap();
-        refs = new TwoLevelMap();
-        metadataInfo = createMetadataInfo(program, {
-            canonicalVisibility: Visibility.Read,
-            canShareProperty: canSharePropertyUsingReadonlyOrXMSMutability,
-        });
-        inProgressInlineTypes = new Set();
-        params = new Map();
-        paramModels = new Set();
-        tags = new Set();
-        operationExamplesMap = new Map();
-        operationIdsWithExample = new Set();
-        outputFile = resolveOutputFile(program, service, multipleService, options, version);
-    }
+    const operationIdsWithExample = new Set();
+    const [exampleMap, diagnostics] = await loadExamples(program.host, options, context.version);
+    program.reportDiagnostics(diagnostics);
+    const services = ignoreDiagnostics(getAllHttpServices(program));
+    const routes = services[0].operations;
+    reportIfNoRoutes(program, routes);
+    routes.forEach(emitOperation);
+    emitParameters();
+    emitSchemas(service.type);
+    emitTags();
+    // Finalize global produces/consumes
+    if (globalProduces.size > 0) {
+        root.produces = [...globalProduces.values()];
+    }
+    else {
+        delete root.produces;
+    }
+    if (globalConsumes.size > 0) {
+        root.consumes = [...globalConsumes.values()];
+    }
+    else {
+        delete root.consumes;
+    }
+    // Clean up empty entries
+    if (root["x-ms-paths"] && Object.keys(root["x-ms-paths"]).length === 0) {
+        delete root["x-ms-paths"];
+    }
+    if (root.security && Object.keys(root.security).length === 0) {
+        delete root["security"];
+    }
+    if (root.securityDefinitions && Object.keys(root.securityDefinitions).length === 0) {
+        delete root["securityDefinitions"];
+    }
+    return {
+        document: root,
+        operationExamples: [...operationIdsWithExample]
+            .map((operationId) => {
+            const data = exampleMap.get(operationId);
+            if (data) {
+                return { operationId, examples: Object.values(data) };
+            }
+            else {
+                return undefined;
+            }
+        })
+            .filter((x) => x),
+    };
     function resolveHost(program, namespace) {
         const servers = getServers(program, namespace);
         if (servers === undefined) {
@@ -192,7 +160,10 @@ function createOAPIEmitter(program, tcgcSdkContext, options) {
         }
         const parameters = [];
         for (const prop of server.parameters.values()) {
-            const param = getOpenAPI2Parameter(prop, "path", Visibility.Read);
+            const param = getOpenAPI2Parameter(prop, "path", {
+                visibility: Visibility.Read,
+                ignoreMetadataAnnotations: false,
+            });
             if (prop.type.kind === "Scalar" &&
                 ignoreDiagnostics(program.checker.isTypeAssignableTo(prop.type.projectionBase ?? prop.type, program.checker.getStdType("url"), prop.type))) {
                 param["x-ms-skip-url-encoding"] = true;
@@ -207,83 +178,6 @@ function createOAPIEmitter(program, tcgcSdkContext, options) {
             },
         };
     }
-    async function emitOpenAPIFromVersion(service, multipleService, version) {
-        initializeEmitter(service, multipleService, version);
-        try {
-            await loadExamples(version);
-            const services = ignoreDiagnostics(getAllHttpServices(program));
-            const routes = services[0].operations;
-            reportIfNoRoutes(program, routes);
-            routes.forEach(emitOperation);
-            emitParameters();
-            emitSchemas(service.type);
-            emitTags();
-            // Finalize global produces/consumes
-            if (globalProduces.size > 0) {
-                root.produces = [...globalProduces.values()];
-            }
-            else {
-                delete root.produces;
-            }
-            if (globalConsumes.size > 0) {
-                root.consumes = [...globalConsumes.values()];
-            }
-            else {
-                delete root.consumes;
-            }
-            // Clean up empty entries
-            if (root["x-ms-paths"] && Object.keys(root["x-ms-paths"]).length === 0) {
-                delete root["x-ms-paths"];
-            }
-            if (root.security && Object.keys(root.security).length === 0) {
-                delete root["security"];
-            }
-            if (root.securityDefinitions && Object.keys(root.securityDefinitions).length === 0) {
-                delete root["securityDefinitions"];
-            }
-            if (!program.compilerOptions.noEmit && !program.hasError()) {
-                // Sort the document
-                const sortedRoot = sortOpenAPIDocument(root);
-                // Write out the OpenAPI document to the output path
-                await emitFile(program, {
-                    path: outputFile,
-                    content: prettierOutput(JSON.stringify(sortedRoot, null, 2)),
-                    newLine: options.newLine,
-                });
-                // Copy examples to the output directory
-                if (options.examplesDirectory && operationIdsWithExample.size > 0) {
-                    const examplesPath = resolvePath(getDirectoryPath(outputFile), "examples");
-                    const exampleDir = version
-                        ? resolvePath(options.examplesDirectory, version)
-                        : resolvePath(options.examplesDirectory);
-                    await program.host.mkdirp(examplesPath);
-                    for (const operationId of operationIdsWithExample) {
-                        const examples = operationExamplesMap.get(operationId);
-                        if (examples) {
-                            for (const [_, fileName] of Object.entries(examples)) {
-                                const content = await program.host.readFile(resolvePath(exampleDir, fileName));
-                                await emitFile(program, {
-                                    path: resolvePath(examplesPath, fileName),
-                                    content: content.text,
-                                    newLine: options.newLine,
-                                });
-                            }
-                        }
-                    }
-                }
-            }
-        }
-        catch (err) {
-            if (err instanceof ErrorTypeFoundError) {
-                // Return early, there must be a parse error if an ErrorType was
-                // inserted into the TypeSpec output
-                return;
-            }
-            else {
-                throw err;
-            }
-        }
-    }
     function parseNextLinkName(paged) {
         const pathComponents = paged.nextLinkSegments;
         if (pathComponents) {
@@ -415,7 +309,7 @@ function createOAPIEmitter(program, tcgcSdkContext, options) {
             currentEndpoint["x-ms-examples"] = examples.reduce((acc, example) => ({ ...acc, [example.title]: { $ref: example.pathOrUri } }), {});
         }
         if (options.examplesDirectory) {
-            const examples = operationExamplesMap.get(currentEndpoint.operationId);
+            const examples = exampleMap.get(currentEndpoint.operationId);
             if (examples && currentEndpoint.operationId) {
                 operationIdsWithExample.add(currentEndpoint.operationId);
                 currentEndpoint["x-ms-examples"] = currentEndpoint["x-ms-examples"] || {};
@@ -536,19 +430,24 @@ function createOAPIEmitter(program, tcgcSdkContext, options) {
                 }
             }
             if (data.body) {
-                if (body && body !== data.body.type) {
+                if (body && body.type !== data.body.type) {
                     reportDiagnostic(program, {
                         code: "duplicate-body-types",
                         target: response.type,
                     });
                 }
-                body = data.body.type;
+                body = data.body;
                 contentTypes.push(...data.body.contentTypes);
             }
         }
         if (body) {
-            const isBinary = contentTypes.every((t) => isBinaryPayload(body, t));
-            openapiResponse.schema = isBinary ? { type: "file" } : getSchemaOrRef(body, Visibility.Read);
+            const isBinary = contentTypes.every((t) => isBinaryPayload(body.type, t));
+            openapiResponse.schema = isBinary
+                ? { type: "file" }
+                : getSchemaOrRef(body.type, {
+                    visibility: Visibility.Read,
+                    ignoreMetadataAnnotations: body.isExplicit && body.containsMetadataAnnotations,
+                });
         }
         for (const contentType of contentTypes) {
             currentProduces.add(contentType);
@@ -557,7 +456,10 @@ function createOAPIEmitter(program, tcgcSdkContext, options) {
     }
     function getResponseHeader(prop) {
         const header = {};
-        populateParameter(header, prop, "header", Visibility.Read);
+        populateParameter(header, prop, "header", {
+            visibility: Visibility.Read,
+            ignoreMetadataAnnotations: false,
+        });
         delete header.in;
         delete header.name;
         delete header.required;
@@ -570,9 +472,9 @@ function createOAPIEmitter(program, tcgcSdkContext, options) {
         if (getRootLength(absoluteRef) === 0) {
             return absoluteRef; // It is already relative.
         }
-        return getRelativePathFromDirectory(getDirectoryPath(outputFile), absoluteRef, false);
+        return getRelativePathFromDirectory(getDirectoryPath(context.outputFile), absoluteRef, false);
     }
-    function getSchemaOrRef(type, visibility) {
+    function getSchemaOrRef(type, schemaContext) {
         const refUrl = getRef(program, type, { version: context.version, service: context.service });
         if (refUrl) {
             return {
@@ -602,12 +504,12 @@ function createOAPIEmitter(program, tcgcSdkContext, options) {
             }
         }
         if (type.kind === "ModelProperty") {
-            return resolveProperty(type, visibility);
+            return resolveProperty(type, schemaContext);
         }
-        type = metadataInfo.getEffectivePayloadType(type, visibility);
+        type = metadataInfo.getEffectivePayloadType(type, schemaContext.visibility);
         const name = getOpenAPITypeName(program, type, typeNameOptions);
         if (shouldInline(program, type)) {
-            const schema = getSchemaForInlineType(type, name, visibility);
+            const schema = getSchemaForInlineType(type, name, schemaContext);
             if (schema === undefined && isErrorType(type)) {
                 // Exit early so that syntax errors are exposed.  This error will
                 // be caught and handled in emitOpenAPI.
@@ -621,18 +523,18 @@ function createOAPIEmitter(program, tcgcSdkContext, options) {
         }
         else {
             // Use shared schema when type is not transformed by visibility from the canonical read visibility.
-            if (!metadataInfo.isTransformed(type, visibility)) {
-                visibility = Visibility.Read;
+            if (!metadataInfo.isTransformed(type, schemaContext.visibility)) {
+                schemaContext = { ...schemaContext, visibility: Visibility.Read };
             }
-            const pending = pendingSchemas.getOrAdd(type, visibility, () => ({
+            const pending = pendingSchemas.getOrAdd(type, schemaContext.visibility, () => ({
                 type,
-                visibility,
-                ref: refs.getOrAdd(type, visibility, () => new Ref()),
+                visibility: schemaContext.visibility,
+                ref: refs.getOrAdd(type, schemaContext.visibility, () => new Ref()),
             }));
             return { $ref: pending.ref };
         }
     }
-    function getSchemaForInlineType(type, name, visibility) {
+    function getSchemaForInlineType(type, name, context) {
         if (inProgressInlineTypes.has(type)) {
             reportDiagnostic(program, {
                 code: "inline-cycle",
@@ -642,7 +544,7 @@ function createOAPIEmitter(program, tcgcSdkContext, options) {
             return {};
         }
         inProgressInlineTypes.add(type);
-        const schema = getSchemaForType(type, visibility);
+        const schema = getSchemaForType(type, context);
         inProgressInlineTypes.delete(type);
         return schema;
     }
@@ -685,11 +587,6 @@ function createOAPIEmitter(program, tcgcSdkContext, options) {
         // `resolveEncodedName` will return the original name if no @encodedName so we have to do that check
         return encodedName === type.name ? viaProjection ?? type.name : encodedName;
     }
-    function getClientName(type) {
-        const viaProjection = getProjectedName(program, type, "client");
-        const clientName = getClientNameOverride(tcgcSdkContext, type);
-        return clientName ?? viaProjection ?? type.name;
-    }
     function emitEndpointParameters(methodParams, visibility) {
         const consumes = methodParams.body?.contentTypes ?? [];
         for (const httpOpParam of methodParams.parameters) {
@@ -701,7 +598,7 @@ function createOAPIEmitter(program, tcgcSdkContext, options) {
             if (httpOpParam.type === "header" && isContentTypeHeader(program, httpOpParam.param)) {
                 continue;
             }
-            emitParameter(httpOpParam.param, httpOpParam.type, visibility, httpOpParam.name);
+            emitParameter(httpOpParam.param, httpOpParam.type, { visibility, ignoreMetadataAnnotations: false }, httpOpParam.name);
         }
         if (consumes.length === 0 && methodParams.body) {
             // we didn't find an explicit content type anywhere, so infer from body.
@@ -714,21 +611,25 @@ function createOAPIEmitter(program, tcgcSdkContext, options) {
         }
         if (methodParams.body && !isVoidType(methodParams.body.type)) {
             const isBinary = isBinaryPayload(methodParams.body.type, consumes);
+            const schemaContext = {
+                visibility,
+                ignoreMetadataAnnotations: methodParams.body.isExplicit && methodParams.body.containsMetadataAnnotations,
+            };
             const schema = isBinary
                 ? { type: "string", format: "binary" }
-                : getSchemaOrRef(methodParams.body.type, visibility);
+                : getSchemaOrRef(methodParams.body.type, schemaContext);
             if (currentConsumes.has("multipart/form-data")) {
                 const bodyModelType = methodParams.body.type;
                 // Assert, this should never happen. Rest library guard against that.
                 compilerAssert(bodyModelType.kind === "Model", "Body should always be a Model.");
                 if (bodyModelType) {
                     for (const param of bodyModelType.properties.values()) {
-                        emitParameter(param, "formData", visibility, getJsonName(param));
+                        emitParameter(param, "formData", schemaContext, getJsonName(param));
                     }
                 }
             }
             else if (methodParams.body.parameter) {
-                emitParameter(methodParams.body.parameter, "body", visibility, getJsonName(methodParams.body.parameter), schema);
+                emitParameter(methodParams.body.parameter, "body", { visibility, ignoreMetadataAnnotations: false }, getJsonName(methodParams.body.parameter), schema);
             }
             else {
                 currentEndpoint.parameters.push({
@@ -755,7 +656,7 @@ function createOAPIEmitter(program, tcgcSdkContext, options) {
         }
         return undefined;
     }
-    function emitParameter(param, kind, visibility, name, typeOverride) {
+    function emitParameter(param, kind, schemaContext, name, typeOverride) {
         if (isNeverType(param.type)) {
             return;
         }
@@ -763,11 +664,11 @@ function createOAPIEmitter(program, tcgcSdkContext, options) {
         currentEndpoint.parameters.push(ph);
         // If the parameter already has a $ref, don't bother populating it
         if (!("$ref" in ph)) {
-            populateParameter(ph, param, kind, visibility, name, typeOverride);
+            populateParameter(ph, param, kind, schemaContext, name, typeOverride);
         }
     }
-    function getSchemaForPrimitiveItems(type, visibility, paramName, multipart) {
-        const fullSchema = getSchemaForType(type, visibility);
+    function getSchemaForPrimitiveItems(type, schemaContext, paramName, multipart) {
+        const fullSchema = getSchemaForType(type, schemaContext);
         if (fullSchema === undefined) {
             return undefined;
         }
@@ -781,7 +682,7 @@ function createOAPIEmitter(program, tcgcSdkContext, options) {
         }
         return fullSchema;
     }
-    function getFormDataSchema(type, visibility, paramName) {
+    function getFormDataSchema(type, schemaContext, paramName) {
         if (isBytes(type)) {
             return { type: "file" };
         }
@@ -790,7 +691,7 @@ function createOAPIEmitter(program, tcgcSdkContext, options) {
             if (isBytes(elementType)) {
                 return { type: "array", items: { type: "string", format: "binary" } };
             }
-            const schema = getSchemaForPrimitiveItems(elementType, visibility, paramName, true);
+            const schema = getSchemaForPrimitiveItems(elementType, schemaContext, paramName, true);
             if (schema === undefined) {
                 return undefined;
             }
@@ -801,14 +702,14 @@ function createOAPIEmitter(program, tcgcSdkContext, options) {
             };
         }
         else {
-            const schema = getSchemaForPrimitiveItems(type, visibility, paramName, true);
+            const schema = getSchemaForPrimitiveItems(type, schemaContext, paramName, true);
             if (schema === undefined) {
                 return undefined;
             }
             return schema;
         }
     }
-    function getOpenAPI2Parameter(param, kind, visibility, name, bodySchema) {
+    function getOpenAPI2Parameter(param, kind, schemaContext, name, bodySchema) {
         const ph = {
             name: name ?? param.name,
             in: kind,
@@ -826,7 +727,7 @@ function createOAPIEmitter(program, tcgcSdkContext, options) {
             ph.schema = bodySchema;
         }
         else if (ph.in === "formData") {
-            Object.assign(ph, getFormDataSchema(param.type, visibility, ph.name));
+            Object.assign(ph, getFormDataSchema(param.type, schemaContext, ph.name));
         }
         else {
             const collectionFormat = (kind === "query"
@@ -843,13 +744,13 @@ function createOAPIEmitter(program, tcgcSdkContext, options) {
             if (param.type.kind === "Model" && isArrayModelType(program, param.type)) {
                 ph.type = "array";
                 const schema = {
-                    ...getSchemaForPrimitiveItems(param.type.indexer.value, visibility, ph.name),
+                    ...getSchemaForPrimitiveItems(param.type.indexer.value, schemaContext, ph.name),
                 };
                 delete schema.description;
                 ph.items = schema;
             }
             else {
-                Object.assign(ph, getSchemaForPrimitiveItems(param.type, visibility, ph.name));
+                Object.assign(ph, getSchemaForPrimitiveItems(param.type, schemaContext, ph.name));
             }
         }
         attachExtensions(param, ph);
@@ -860,8 +761,8 @@ function createOAPIEmitter(program, tcgcSdkContext, options) {
         Object.assign(ph, applyIntrinsicDecorators(param, { type: ph.type, format: ph.format }));
         return ph;
     }
-    function populateParameter(ph, param, kind, visibility, name, bodySchema) {
-        Object.assign(ph, getOpenAPI2Parameter(param, kind, visibility, name, bodySchema));
+    function populateParameter(ph, param, kind, schemaContext, name, bodySchema) {
+        Object.assign(ph, getOpenAPI2Parameter(param, kind, schemaContext, name, bodySchema));
     }
     function emitParameters() {
         for (const [property, param] of params) {
@@ -910,7 +811,10 @@ function createOAPIEmitter(program, tcgcSdkContext, options) {
                     for (const [visibility, pending] of group) {
                         processedSchemas.getOrAdd(type, visibility, () => ({
                             ...pending,
-                            schema: getSchemaForType(type, visibility),
+                            schema: getSchemaForType(type, {
+                                visibility: visibility,
+                                ignoreMetadataAnnotations: false,
+                            }),
                         }));
                     }
                     pendingSchemas.delete(type);
@@ -920,7 +824,7 @@ function createOAPIEmitter(program, tcgcSdkContext, options) {
         function processUnreferencedSchemas() {
             const addSchema = (type) => {
                 if (!processedSchemas.has(type) && !paramModels.has(type) && !shouldInline(program, type)) {
-                    getSchemaOrRef(type, Visibility.Read);
+                    getSchemaOrRef(type, { visibility: Visibility.Read, ignoreMetadataAnnotations: false });
                 }
             };
             const skipSubNamespaces = isGlobalNamespace(program, serviceNamespace);
@@ -938,67 +842,7 @@ function createOAPIEmitter(program, tcgcSdkContext, options) {
             root.tags.push({ name: tag });
         }
     }
-    async function loadExamples(version) {
-        if (options.examplesDirectory) {
-            const exampleDir = version
-                ? resolvePath(options.examplesDirectory, version)
-                : resolvePath(options.examplesDirectory);
-            try {
-                if (!(await program.host.stat(exampleDir)).isDirectory())
-                    return;
-            }
-            catch (err) {
-                reportDiagnostic(program, {
-                    code: "example-loading",
-                    messageId: "noDirectory",
-                    format: { directory: exampleDir },
-                    target: NoTarget,
-                });
-                return;
-            }
-            const exampleFiles = await program.host.readDir(exampleDir);
-            for (const fileName of exampleFiles) {
-                try {
-                    const exampleFile = await program.host.readFile(resolvePath(exampleDir, fileName));
-                    const example = JSON.parse(exampleFile.text);
-                    if (!example.operationId || !example.title) {
-                        reportDiagnostic(program, {
-                            code: "example-loading",
-                            messageId: "noOperationId",
-                            format: { filename: fileName },
-                            target: NoTarget,
-                        });
-                        continue;
-                    }
-                    if (!operationExamplesMap.has(example.operationId)) {
-                        operationExamplesMap.set(example.operationId, {});
-                    }
-                    const examples = operationExamplesMap.get(example.operationId);
-                    if (example.title in examples) {
-                        reportDiagnostic(program, {
-                            code: "duplicate-example-file",
-                            target: NoTarget,
-                            format: {
-                                filename: fileName,
-                                operationId: example.operationId,
-                                title: example.title,
-                            },
-                        });
-                    }
-                    examples[example.title] = fileName;
-                }
-                catch (err) {
-                    reportDiagnostic(program, {
-                        code: "example-loading",
-                        messageId: "default",
-                        format: { filename: fileName, error: err?.toString() ?? "" },
-                        target: NoTarget,
-                    });
-                }
-            }
-        }
-    }
-    function getSchemaForType(type, visibility) {
+    function getSchemaForType(type, schemaContext) {
         const builtinType = getSchemaForLiterals(type);
         if (builtinType !== undefined) {
             return builtinType;
@@ -1007,15 +851,15 @@ function createOAPIEmitter(program, tcgcSdkContext, options) {
             case "Intrinsic":
                 return getSchemaForIntrinsicType(type);
             case "Model":
-                return getSchemaForModel(type, visibility);
+                return getSchemaForModel(type, schemaContext);
             case "ModelProperty":
-                return getSchemaForType(type.type, visibility);
+                return getSchemaForType(type.type, schemaContext);
             case "Scalar":
                 return getSchemaForScalar(type);
             case "Union":
-                return getSchemaForUnion(type, visibility);
+                return getSchemaForUnion(type, schemaContext);
             case "UnionVariant":
-                return getSchemaForUnionVariant(type, visibility);
+                return getSchemaForUnionVariant(type, schemaContext);
             case "Enum":
                 return getSchemaForEnum(type);
             case "Tuple":
@@ -1114,7 +958,7 @@ function createOAPIEmitter(program, tcgcSdkContext, options) {
         }
         return applyIntrinsicDecorators(union, schema);
     }
-    function getSchemaForUnion(union, visibility) {
+    function getSchemaForUnion(union, schemaContext) {
         const nonNullOptions = [...union.variants.values()]
             .map((x) => x.type)
             .filter((t) => !isNullType(t));
@@ -1126,7 +970,7 @@ function createOAPIEmitter(program, tcgcSdkContext, options) {
         if (nonNullOptions.length === 1) {
             const type = nonNullOptions[0];
             // Get the schema for the model type
-            const schema = getSchemaOrRef(type, visibility);
+            const schema = getSchemaOrRef(type, schemaContext);
             if (schema.$ref) {
                 if (type.kind === "Model") {
                     return { type: "object", allOf: [schema], "x-nullable": nullable };
@@ -1159,8 +1003,8 @@ function createOAPIEmitter(program, tcgcSdkContext, options) {
         return (getExtensions(program, array).has("x-ms-identifiers") ||
             getProperty(array.indexer.value, "id"));
     }
-    function getSchemaForUnionVariant(variant, visibility) {
-        return getSchemaForType(variant.type, visibility);
+    function getSchemaForUnionVariant(variant, schemaContext) {
+        return getSchemaForType(variant.type, schemaContext);
     }
     function getDefaultValue(type) {
         switch (type.kind) {
@@ -1220,8 +1064,8 @@ function createOAPIEmitter(program, tcgcSdkContext, options) {
         }
         return undefined;
     }
-    function getSchemaForModel(model, visibility) {
-        const array = getArrayType(model, visibility);
+    function getSchemaForModel(model, schemaContext) {
+        const array = getArrayType(model, schemaContext);
         if (array) {
             return array;
         }
@@ -1240,12 +1084,12 @@ function createOAPIEmitter(program, tcgcSdkContext, options) {
         }
         const properties = {};
         if (isRecordModelType(program, model)) {
-            modelSchema.additionalProperties = getSchemaOrRef(model.indexer.value, visibility);
+            modelSchema.additionalProperties = getSchemaOrRef(model.indexer.value, schemaContext);
         }
         const derivedModels = model.derivedModels.filter(includeDerivedModel);
         // getSchemaOrRef on all children to push them into components.schemas
         for (const child of derivedModels) {
-            getSchemaOrRef(child, visibility);
+            getSchemaOrRef(child, schemaContext);
         }
         const discriminator = getDiscriminator(program, model);
         if (discriminator) {
@@ -1262,7 +1106,7 @@ function createOAPIEmitter(program, tcgcSdkContext, options) {
         }
         applyExternalDocs(model, modelSchema);
         for (const prop of model.properties.values()) {
-            if (!metadataInfo.isPayloadProperty(prop, visibility)) {
+            if (!metadataInfo.isPayloadProperty(prop, schemaContext.visibility, schemaContext.ignoreMetadataAnnotations)) {
                 continue;
             }
             if (isNeverType(prop.type)) {
@@ -1270,7 +1114,7 @@ function createOAPIEmitter(program, tcgcSdkContext, options) {
                 continue;
             }
             const jsonName = getJsonName(prop);
-            const clientName = getClientName(prop);
+            const clientName = getClientName(context, prop);
             const description = getDoc(program, prop);
             // if this property is a discriminator property, remove it to keep autorest validation happy
             if (model.baseModel) {
@@ -1279,14 +1123,15 @@ function createOAPIEmitter(program, tcgcSdkContext, options) {
                     continue;
                 }
             }
-            if (!metadataInfo.isOptional(prop, visibility) || prop.name === discriminator?.propertyName) {
+            if (!metadataInfo.isOptional(prop, schemaContext.visibility) ||
+                prop.name === discriminator?.propertyName) {
                 if (!modelSchema.required) {
                     modelSchema.required = [];
                 }
                 modelSchema.required.push(jsonName);
             }
             // Apply decorators on the property to the type's schema
-            properties[jsonName] = resolveProperty(prop, visibility);
+            properties[jsonName] = resolveProperty(prop, schemaContext);
             const property = properties[jsonName];
             if (jsonName !== clientName) {
                 property["x-ms-client-name"] = clientName;
@@ -1331,11 +1176,11 @@ function createOAPIEmitter(program, tcgcSdkContext, options) {
             Object.keys(properties).length === 0) {
             // Take the base model schema but carry across the documentation property
             // that we set before
-            const baseSchema = getSchemaForType(model.baseModel, visibility);
+            const baseSchema = getSchemaForType(model.baseModel, schemaContext);
             Object.assign(modelSchema, baseSchema, { description: modelSchema.description });
         }
         else if (model.baseModel) {
-            const baseSchema = getSchemaOrRef(model.baseModel, visibility);
+            const baseSchema = getSchemaOrRef(model.baseModel, schemaContext);
             modelSchema.allOf = [baseSchema];
         }
         if (Object.keys(properties).length > 0) {
@@ -1357,7 +1202,7 @@ function createOAPIEmitter(program, tcgcSdkContext, options) {
         }
         return true;
     }
-    function resolveProperty(prop, visibility) {
+    function resolveProperty(prop, context) {
         let propSchema;
         if (prop.type.kind === "Enum" && prop.default) {
             propSchema = getSchemaForEnum(prop.type);
@@ -1368,11 +1213,11 @@ function createOAPIEmitter(program, tcgcSdkContext, options) {
                 propSchema = getSchemaForUnionEnum(prop.type, asEnum);
             }
             else {
-                propSchema = getSchemaOrRef(prop.type, visibility);
+                propSchema = getSchemaOrRef(prop.type, context);
             }
         }
         else {
-            propSchema = getSchemaOrRef(prop.type, visibility);
+            propSchema = getSchemaOrRef(prop.type, context);
         }
         return applyIntrinsicDecorators(prop, propSchema);
     }
@@ -1492,7 +1337,7 @@ function createOAPIEmitter(program, tcgcSdkContext, options) {
             }
         }
         if (typespecType.kind === "ModelProperty" &&
-            shouldFlattenProperty(tcgcSdkContext, typespecType)) {
+            shouldFlattenProperty(context.tcgcSdkContext, typespecType)) {
             newTarget["x-ms-client-flatten"] = true;
         }
         attachExtensions(typespecType, newTarget);
@@ -1603,11 +1448,14 @@ function createOAPIEmitter(program, tcgcSdkContext, options) {
     /**
      * If the model is an array model return the OpenAPI2Schema for the array type.
      */
-    function getArrayType(typespecType, visibility) {
+    function getArrayType(typespecType, context) {
         if (isArrayModelType(program, typespecType)) {
             const array = {
                 type: "array",
-                items: getSchemaOrRef(typespecType.indexer.value, visibility | Visibility.Item),
+                items: getSchemaOrRef(typespecType.indexer.value, {
+                    ...context,
+                    visibility: context.visibility | Visibility.Item,
+                }),
             };
             if (!ifArrayItemContainsIdentifier(program, typespecType)) {
                 array["x-ms-identifiers"] = [];
@@ -1766,7 +1614,7 @@ function createOAPIEmitter(program, tcgcSdkContext, options) {
                 reportDiagnostic(program, {
                     code: "unsupported-auth",
                     format: { authType: auth.type },
-                    target: currentService.type,
+                    target: service.type,
                 });
                 return undefined;
         }
@@ -1787,9 +1635,6 @@ function createOAPIEmitter(program, tcgcSdkContext, options) {
         }
     }
 }
-function prettierOutput(output) {
-    return output + "\n";
-}
 class ErrorTypeFoundError extends Error {
     constructor() {
         super("Error type found in evaluated TypeSpec output");
@@ -1801,24 +1646,71 @@ export function sortOpenAPIDocument(doc) {
     const sorted = sortWithJsonSchema(unsorted, AutorestOpenAPISchema, "#/$defs/AutorestOpenAPISchema");
     return sorted;
 }
-function resolveOutputFile(program, service, multipleServices, options, version) {
-    const azureResourceProviderFolder = options.azureResourceProviderFolder;
-    if (azureResourceProviderFolder) {
-        const info = resolveInfo(program, service.type);
-        version = version ?? info?.version ?? "0000-00-00";
-    }
-    const interpolated = interpolatePath(options.outputFile, {
-        "azure-resource-provider-folder": azureResourceProviderFolder,
-        "service-name": multipleServices || azureResourceProviderFolder
-            ? getNamespaceFullName(service.type)
-            : undefined,
-        "version-status": azureResourceProviderFolder
-            ? version?.includes("preview")
-                ? "preview"
-                : "stable"
-            : undefined,
-        version,
-    });
-    return resolvePath(options.outputDir, interpolated);
+async function loadExamples(host, options, version) {
+    const diagnostics = createDiagnosticCollector();
+    if (!options.examplesDirectory) {
+        return diagnostics.wrap(new Map());
+    }
+    const exampleDir = version
+        ? resolvePath(options.examplesDirectory, version)
+        : resolvePath(options.examplesDirectory);
+    try {
+        if (!(await host.stat(exampleDir)).isDirectory())
+            return diagnostics.wrap(new Map());
+    }
+    catch (err) {
+        diagnostics.add(createDiagnostic({
+            code: "example-loading",
+            messageId: "noDirectory",
+            format: { directory: exampleDir },
+            target: NoTarget,
+        }));
+        return diagnostics.wrap(new Map());
+    }
+    const map = new Map();
+    const exampleFiles = await host.readDir(exampleDir);
+    for (const fileName of exampleFiles) {
+        try {
+            const exampleFile = await host.readFile(resolvePath(exampleDir, fileName));
+            const example = JSON.parse(exampleFile.text);
+            if (!example.operationId || !example.title) {
+                diagnostics.add(createDiagnostic({
+                    code: "example-loading",
+                    messageId: "noOperationId",
+                    format: { filename: fileName },
+                    target: NoTarget,
+                }));
+                continue;
+            }
+            if (!map.has(example.operationId)) {
+                map.set(example.operationId, {});
+            }
+            const examples = map.get(example.operationId);
+            if (example.title in examples) {
+                diagnostics.add(createDiagnostic({
+                    code: "duplicate-example-file",
+                    target: NoTarget,
+                    format: {
+                        filename: fileName,
+                        operationId: example.operationId,
+                        title: example.title,
+                    },
+                }));
+            }
+            examples[example.title] = {
+                file: exampleFile,
+                data: example,
+            };
+        }
+        catch (err) {
+            diagnostics.add(createDiagnostic({
+                code: "example-loading",
+                messageId: "default",
+                format: { filename: fileName, error: err?.toString() ?? "" },
+                target: NoTarget,
+            }));
+        }
+    }
+    return diagnostics.wrap(new Map());
 }
 //# sourceMappingURL=openapi.js.map