OpenAPI3 with emitter framework (for schemas)

common/changes/@typespec/compiler/openapi3-emitter-framework_2023-11-06-20-02.json

@@ -0,0 +1,10 @@
+{
+  "changes": [
+    {
+      "packageName": "@typespec/compiler",
+      "comment": "Emitter framework: Allow passing a custom context when calling `emitType` ",
+      "type": "none"
+    }
+  ],
+  "packageName": "@typespec/compiler"
+}

common/changes/@typespec/openapi3/openapi3-emitter-framework_2023-11-06-20-02.json

@@ -0,0 +1,10 @@
+{
+  "changes": [
+    {
+      "packageName": "@typespec/openapi3",
+      "comment": "Migrate code to use the emitter framework",
+      "type": "none"
+    }
+  ],
+  "packageName": "@typespec/openapi3"
+}

packages/compiler/src/emitter-framework/asset-emitter.ts

@@ -316,7 +316,16 @@ export function createAssetEmitter<T, TOptions extends object>(
       return typeEmitter.writeOutput(sourceFiles);
     },
 
-    emitType(type) {
+    getSourceFiles() {
+      return sourceFiles;
+    },
+
+    emitType(type, context?: ContextState) {
+      if (context?.referenceContext) {
+        incomingReferenceContext = context?.referenceContext ?? incomingReferenceContext;
+        incomingReferenceContextTarget = type ?? incomingReferenceContextTarget;
+      }
+
       const declName =
         isDeclaration(type) && type.kind !== "Namespace" ? typeEmitter.declarationName(type) : null;
       const key = typeEmitterKey(type);

packages/compiler/src/emitter-framework/builders/array-builder.ts

@@ -13,12 +13,12 @@ export class ArrayBuilder<T> extends Array {
 
   push(...values: (EmitEntity<T> | Placeholder<T> | T)[]): number {
     for (const v of values) {
-      let toPush: Placeholder<T> | T | null;
+      let toPush: Placeholder<T> | T | undefined;
       if (v instanceof EmitterResult) {
         compilerAssert(v.kind !== "circular", "Can't push a circular emit result.");
 
         if (v.kind === "none") {
-          toPush = null;
+          toPush = undefined;
         } else {
           toPush = v.value;
         }

packages/compiler/src/emitter-framework/builders/object-builder.ts

@@ -27,7 +27,7 @@ export class ObjectBuilder<T> {
       compilerAssert(v.kind !== "circular", "Can't set a circular emit result.");
 
       if (v.kind === "none") {
-        this[key] = null;
+        this[key] = undefined;
         return;
       } else {
         value = v.value;

packages/compiler/src/emitter-framework/types.ts

@@ -30,7 +30,7 @@ export interface AssetEmitter<T, TOptions extends object = Record<string, unknow
   getProgram(): Program;
   emitTypeReference(type: Type): EmitEntity<T>;
   emitDeclarationName(type: TypeSpecDeclaration): string | undefined;
-  emitType(type: Type): EmitEntity<T>;
+  emitType(type: Type, context?: Partial<ContextState>): EmitEntity<T>;
   emitProgram(options?: { emitGlobalNamespace?: boolean; emitTypeSpecNamespace?: boolean }): void;
   emitModelProperties(model: Model): EmitEntity<T>;
   emitModelProperty(prop: ModelProperty): EmitEntity<T>;
@@ -57,6 +57,9 @@ export interface AssetEmitter<T, TOptions extends object = Record<string, unknow
     none(): NoEmit;
   };
   writeOutput(): Promise<void>;
+
+  /** Get source files that have been scoped. */
+  getSourceFiles(): SourceFile<T>[];
 }
 
 export interface ScopeBase<T> {