@azure-tools/typespec-ts 0.55.0 → 0.55.2

package/src/index.ts

@@ -10,7 +10,7 @@ import {
   resolvePath,
   type CompilerHost,
 } from "@typespec/compiler";
-import { provideContext, useContext } from "./context-manager.js";
+import { clearContexts, provideContext, useContext } from "./context-manager.js";
 import { buildRootIndex, buildSubClientIndexFile } from "./modular/build-root-index.js";
 import {
   AzureCoreDependencies,
@@ -31,37 +31,6 @@ import {
   UrlTemplateHelpers,
   XmlHelpers,
 } from "./modular/static-helpers-metadata.js";
-import {
-  RLCModel,
-  RLCOptions,
-  buildApiExtractorConfig,
-  buildChangelogFile,
-  buildEsLintConfig,
-  buildLicenseFile,
-  buildPackageFile,
-  buildReadmeFile,
-  buildRecordedClientFile,
-  buildSampleEnvFile,
-  buildSampleTest,
-  buildSnippets,
-  buildTestBrowserTsConfig,
-  buildTestNodeTsConfig,
-  buildTsConfig,
-  buildTsLintConfig,
-  buildTsSampleConfig,
-  buildTsSnippetsConfig,
-  buildTsSrcBrowserConfig,
-  buildTsSrcCjsConfig,
-  buildTsSrcEsmConfig,
-  buildTsSrcReactNativeConfig,
-  buildVitestConfig,
-  buildWarpConfig,
-  getClientName,
-  hasClientNameChanged,
-  hasUnexpectedHelper,
-  updatePackageFile,
-  updateReadmeFile,
-} from "./rlc-common/index.js";
 import { emitContentByBuilder } from "./utils/emit-util.js";
 import { clearDirectory, emptyDir, pathExists } from "./utils/file-system-utils.js";
 import { GenerationDirDetail, SdkContext } from "./utils/interfaces.js";
@@ -74,9 +43,37 @@ import {
 } from "@azure-tools/typespec-client-generator-core";
 import { Project } from "ts-morph";
 import { provideBinder } from "./framework/hooks/binder.js";
-import { provideSdkTypes } from "./framework/hooks/sdk-types.js";
+import { provideSdkTypes, resetSdkTypesState } from "./framework/hooks/sdk-types.js";
 import { loadStaticHelpers } from "./framework/load-static-helpers.js";
+import { ClientModel, ClientOptions } from "./interfaces.js";
 import { EmitterOptions } from "./lib.js";
+import { buildApiExtractorConfig } from "./metadata/build-api-extractor-config.js";
+import { buildChangelogFile } from "./metadata/build-changelog-file.js";
+import { buildEsLintConfig } from "./metadata/build-es-lint-config.js";
+import { buildLicenseFile } from "./metadata/build-license-file.js";
+import { buildPackageFile, updatePackageFile } from "./metadata/build-package-file.js";
+import {
+  buildReadmeFile,
+  hasClientNameChanged,
+  updateReadmeFile,
+} from "./metadata/build-readme-file.js";
+import { buildSampleEnvFile } from "./metadata/build-sample-env-file.js";
+import { buildTestBrowserTsConfig, buildTestNodeTsConfig } from "./metadata/build-test-config.js";
+import {
+  buildTsConfig,
+  buildTsLintConfig,
+  buildTsSampleConfig,
+  buildTsSnippetsConfig,
+  buildTsSrcBrowserConfig,
+  buildTsSrcCjsConfig,
+  buildTsSrcEsmConfig,
+  buildTsSrcReactNativeConfig,
+} from "./metadata/build-ts-config.js";
+import { buildVitestConfig } from "./metadata/build-vitest-config.js";
+import { buildWarpConfig } from "./metadata/build-warp-config.js";
+import { buildRecordedClientFile } from "./metadata/test/build-recorded-client.js";
+import { buildSampleTest } from "./metadata/test/build-sample-test.js";
+import { buildSnippets } from "./metadata/test/build-snippets.js";
 import { buildClassicalClient } from "./modular/build-classical-client.js";
 import { buildClassicOperationFiles } from "./modular/build-classical-operation-groups.js";
 import { buildClientContext, getClientContextPath } from "./modular/build-client-context.js";
@@ -93,13 +90,9 @@ import { emitTests } from "./modular/emit-tests.js";
 import { getClassicalClientName } from "./modular/helpers/naming-helpers.js";
 import { ModularEmitterOptions } from "./modular/interfaces.js";
 import { packageUsesXmlSerialization } from "./modular/serialization/build-xml-serializer-function.js";
-import { transformRLCModel } from "./transform/transform.js";
-import { transformRLCOptions } from "./transform/transfrom-rlc-options.js";
-import {
-  getClientHierarchyMap,
-  getModularClientOptions,
-  getRLCClients,
-} from "./utils/client-utils.js";
+import { transformClientOptions } from "./transform/transform-client-options.js";
+import { transformClientModel } from "./transform/transform.js";
+import { getClientHierarchyMap, getClientModuleInfo, getClients } from "./utils/client-utils.js";
 import { generateCrossLanguageDefinitionFile } from "./utils/cross-language-def.js";
 
 export * from "./lib.js";
@@ -128,11 +121,9 @@ export async function $onEmit(context: EmitContext) {
 
   // Enrich the dpg context with path detail and common options
   await enrichDpgContext();
-  const rlcOptions = dpgContext.rlcOptions ?? {};
+  const resolvedEmitterOptions = dpgContext.emitterOptions ?? {};
 
-  const needUnexpectedHelper: Map<string, boolean> = new Map<string, boolean>();
-  const serviceNameToRlcModelsMap: Map<string, RLCModel> = new Map<string, RLCModel>();
-  provideContext("rlcMetaTree", new Map());
+  provideContext("clientTypeMetaTree", new Map());
   provideContext("symbolMap", new Map());
   provideContext("outputProject", outputProject);
   provideContext("emitContext", {
@@ -151,13 +142,13 @@ export async function $onEmit(context: EmitContext) {
       ...PlatformTypeHelpers,
       ...CloudSettingHelpers,
       ...XmlHelpers,
-      ...(rlcOptions.generateTest ? CreateRecorderHelpers : {}),
-      ...(rlcOptions.enableStorageCompat ? StorageCompatHelpers : {}),
+      ...(resolvedEmitterOptions.generateTest ? CreateRecorderHelpers : {}),
+      ...(resolvedEmitterOptions.enableStorageCompat ? StorageCompatHelpers : {}),
     },
     {
-      sourcesDir: dpgContext.generationPathDetail?.modularSourcesDir,
+      sourcesDir: dpgContext.generationPathDetail?.sourcesDir,
       rootDir: dpgContext.generationPathDetail?.rootDir,
-      options: rlcOptions,
+      options: resolvedEmitterOptions,
       program,
       host,
       packageRoot: emitterPackageRoot,
@@ -178,20 +169,16 @@ export async function $onEmit(context: EmitContext) {
   });
   provideSdkTypes(dpgContext);
 
-  const rlcCodeModels: RLCModel[] = [];
   let modularEmitterOptions: ModularEmitterOptions;
   // 1. Clear sources folder
   await clearSrcFolder();
-  // 2. Generate RLC code model
-  // TODO: skip this step in modular once modular generator is sufficiently decoupled
-  await buildRLCCodeModels();
-  // 3. Clear samples-dev folder if generateSample is true
+  // 2. Clear samples-dev folder if generateSample is true
   await clearSamplesDevFolder();
 
-  // 4. Generate sources
-  await generateModularSources();
+  // 3. Generate sources
+  await generateSources();
 
-  // 5. Generate metadata and test files
+  // 4. Generate metadata and test files
   function getTypespecTsVersion(context: EmitContext): string | undefined {
     const emitterMetadata = context.program.emitters.find(
       (emitter) => emitter.metadata.name === "@azure-tools/typespec-ts",
@@ -201,11 +188,20 @@ export async function $onEmit(context: EmitContext) {
 
   await generateMetadataAndTest(dpgContext);
 
+  // Release the emitter's process-wide singleton state now that this emit has
+  // finished writing output. Without this, the context manager keeps the whole
+  // previous program graph (compiler `EmitContext`/`Program`, TCGC `SdkContext`,
+  // ts-morph `Project`, binder, …) reachable until the next emit overwrites it.
+  // Clearing here lets it be collected between emits, which matters for hosts
+  // that run many emits in one process (test suites, benchmarks, watch mode).
+  clearContexts();
+  resetSdkTypesState();
+
   async function enrichDpgContext() {
     const generationPathDetail: GenerationDirDetail = await calculateGenerationDir();
     dpgContext.generationPathDetail = generationPathDetail;
     dpgContext.allServiceNamespaces = listAllServiceNamespaces(dpgContext);
-    const options: RLCOptions = transformRLCOptions(emitterOptions, dpgContext);
+    const options: ClientOptions = transformClientOptions(emitterOptions, dpgContext);
     emitterOptions["generate-sample"] = options.generateSample;
     // clear output folder if needed
     if (options.clearOutputFolder) {
@@ -219,7 +215,7 @@ export async function $onEmit(context: EmitContext) {
     options.generateTest =
       options.generateTest === true ||
       (options.generateTest === undefined && (!hasTestFolder || options.azureArm));
-    dpgContext.rlcOptions = options;
+    dpgContext.emitterOptions = options;
   }
 
   async function calculateGenerationDir(): Promise<GenerationDirDetail> {
@@ -236,18 +232,12 @@ export async function $onEmit(context: EmitContext) {
     return {
       rootDir: projectRoot,
       metadataDir: projectRoot,
-      rlcSourcesDir: sourcesRoot,
-      modularSourcesDir: sourcesRoot,
+      sourcesDir: sourcesRoot,
     };
   }
 
   async function clearSrcFolder() {
-    await emptyDir(
-      host,
-      dpgContext.generationPathDetail?.modularSourcesDir ??
-        dpgContext.generationPathDetail?.rlcSourcesDir ??
-        "",
-    );
+    await emptyDir(host, dpgContext.generationPathDetail?.sourcesDir ?? "");
   }
 
   async function clearSamplesDevFolder() {
@@ -262,32 +252,30 @@ export async function $onEmit(context: EmitContext) {
     }
   }
 
-  async function buildRLCCodeModels() {
-    const clients = getRLCClients(dpgContext);
+  async function buildClientCodeModels(): Promise<ClientModel[]> {
+    const models: ClientModel[] = [];
+    const clients = getClients(dpgContext);
     for (const client of clients) {
-      const rlcModels = await transformRLCModel(client, dpgContext);
-      rlcCodeModels.push(rlcModels);
-      const serviceName = client.services[0]?.name ?? "Unknown";
-      serviceNameToRlcModelsMap.set(serviceName, rlcModels);
-      needUnexpectedHelper.set(getClientName(rlcModels), hasUnexpectedHelper(rlcModels));
+      models.push(await transformClientModel(client, dpgContext));
     }
+    return models;
   }
 
-  async function generateModularSources() {
-    const modularSourcesRoot = dpgContext.generationPathDetail?.modularSourcesDir ?? "src";
+  async function generateSources() {
+    const sourcesRoot = dpgContext.generationPathDetail?.sourcesDir ?? "src";
     const project = useContext("outputProject");
-    modularEmitterOptions = transformModularEmitterOptions(dpgContext, modularSourcesRoot, {
+    modularEmitterOptions = transformModularEmitterOptions(dpgContext, sourcesRoot, {
       casing: "camel",
     });
 
-    emitLoggerFile(modularEmitterOptions, modularSourcesRoot);
+    emitLoggerFile(modularEmitterOptions, sourcesRoot);
 
-    const rootIndexFile = project.createSourceFile(`${modularSourcesRoot}/index.ts`, "", {
+    const rootIndexFile = project.createSourceFile(`${sourcesRoot}/index.ts`, "", {
       overwrite: true,
     });
 
-    emitTypes(dpgContext, { sourceRoot: modularSourcesRoot });
-    emitNonModelResponseTypes(dpgContext, { sourceRoot: modularSourcesRoot });
+    emitTypes(dpgContext, { sourceRoot: sourcesRoot });
+    emitNonModelResponseTypes(dpgContext, { sourceRoot: sourcesRoot });
     buildSubpathIndexFile(modularEmitterOptions, "models", undefined, {
       recursive: true,
     });
@@ -302,7 +290,7 @@ export async function $onEmit(context: EmitContext) {
       buildOperationFiles(dpgContext, subClient, modularEmitterOptions);
       buildClientContext(dpgContext, subClient, modularEmitterOptions);
       buildRestorePoller(dpgContext, subClient, modularEmitterOptions);
-      if (dpgContext.rlcOptions?.hierarchyClient) {
+      if (dpgContext.emitterOptions?.hierarchyClient) {
         buildSubpathIndexFile(modularEmitterOptions, "api", subClient, {
           exportIndex: false,
           recursive: true,
@@ -320,24 +308,24 @@ export async function $onEmit(context: EmitContext) {
         exportIndex: true,
         interfaceOnly: true,
       });
-      const { subfolder } = getModularClientOptions(subClient);
+      const { subfolder } = getClientModuleInfo(subClient);
       // Generate index file for clients with subfolders (multi-client scenarios and nested clients)
       if (subfolder) {
         buildSubClientIndexFile(dpgContext, subClient, modularEmitterOptions);
       }
       buildRootIndex(dpgContext, modularEmitterOptions, rootIndexFile, subClient);
     }
-    // Enable modular sample generation when explicitly set to true or MPG
+    // Sample generation is enabled only when the modular generator actually emits
+    // samples. Reset the baseline here, then re-enable it below if any are emitted.
+    dpgContext.emitterOptions!.generateSample = false;
     if (emitterOptions["generate-sample"] === true) {
       const samples = emitSamples(dpgContext);
-      // Refine the rlc sample generation logic
-      // TODO: remember to remove this out when RLC is splitted from Modular
       if (samples.length > 0) {
-        dpgContext.rlcOptions!.generateSample = true;
+        dpgContext.emitterOptions!.generateSample = true;
       }
     }
 
-    binder.resolveAllReferences(modularSourcesRoot, dpgContext.generationPathDetail?.rootDir);
+    binder.resolveAllReferences(sourcesRoot, dpgContext.generationPathDetail?.rootDir);
     if (program.compilerOptions.noEmit || program.hasError()) {
       return;
     }
@@ -382,17 +370,18 @@ export async function $onEmit(context: EmitContext) {
 
   async function generateMetadataAndTest(context: SdkContext) {
     const project = useContext("outputProject");
-    if (rlcCodeModels.length === 0 || !rlcCodeModels[0]) {
+    const clientCodeModels = await buildClientCodeModels();
+    if (clientCodeModels.length === 0 || !clientCodeModels[0]) {
       return;
     }
-    const rlcClient: RLCModel = rlcCodeModels[0];
-    const option = dpgContext.rlcOptions!;
+    const clientModel: ClientModel = clientCodeModels[0];
+    const option = dpgContext.emitterOptions!;
     // When generateMetadata is explicitly false and the sources are generated
     // into a path ending with "generated" (e.g. src/generated), this package
     // has a manual convenience layer. Skip all metadata/test file generation
     // to avoid unexpected modifications to files like package.json, README.md,
     // warp.config.yml, and snippets.spec.ts. metadata.json is still updated.
-    const sourcesDir = dpgContext.generationPathDetail?.modularSourcesDir ?? "";
+    const sourcesDir = dpgContext.generationPathDetail?.sourcesDir ?? "";
     const hasManualConvenienceLayer = getBaseFileName(sourcesDir) === "generated";
     // Generate metadata
     const existingPackageFilePath = joinPaths(
@@ -426,7 +415,7 @@ export async function $onEmit(context: EmitContext) {
 
     //TODO Need consider multi-client cases
     for (const subClient of dpgContext.sdkPackage.clients) {
-      rlcClient.libraryName = subClient.name;
+      clientModel.libraryName = subClient.name;
     }
 
     if (shouldGenerateMetadata) {
@@ -473,12 +462,12 @@ export async function $onEmit(context: EmitContext) {
       // Generate warp.config.yml for Azure monorepo ESM packages
       commonBuilders.push((model) => buildWarpConfig(model, modularPackageInfo));
       commonBuilders.push(buildTsConfig);
-      commonBuilders.push(buildTsSrcEsmConfig);
-      commonBuilders.push(buildTsSrcBrowserConfig);
+      commonBuilders.push(() => buildTsSrcEsmConfig(modularPackageInfo["exports"]));
+      commonBuilders.push(() => buildTsSrcBrowserConfig(modularPackageInfo["exports"]));
       if (option.generateReactNativeTarget) {
-        commonBuilders.push(buildTsSrcReactNativeConfig);
+        commonBuilders.push(() => buildTsSrcReactNativeConfig(modularPackageInfo["exports"]));
       }
-      commonBuilders.push(buildTsSrcCjsConfig);
+      commonBuilders.push(() => buildTsSrcCjsConfig(modularPackageInfo["exports"]));
       if (option.generateSample) {
         commonBuilders.push(buildTsSampleConfig);
       }
@@ -496,7 +485,7 @@ export async function $onEmit(context: EmitContext) {
       await emitContentByBuilder(
         program,
         commonBuilders,
-        rlcClient,
+        clientModel,
         dpgContext.generationPathDetail?.metadataDir,
       );
 
@@ -525,8 +514,8 @@ export async function $onEmit(context: EmitContext) {
         }),
       };
 
-      // Always update package.json (adds #platform/* imports) and, for modular
-      // packages, exports, clientContextPaths and LRO deps.
+      // Always update package.json (adds #platform/* imports) along with
+      // exports, clientContextPaths and LRO deps.
       {
         // Read package.json content via host and pass parsed object
         const pkgSourceFile = await host.readFile(existingPackageFilePath);
@@ -536,30 +525,38 @@ export async function $onEmit(context: EmitContext) {
         } catch {
           packageInfo = {};
         }
-        updateBuilders.push((model: RLCModel) =>
+        updateBuilders.push((model: ClientModel) =>
           updatePackageFile(model, packageInfo, modularPackageInfo),
         );
       }
 
       // Update warp.config.yml for Azure monorepo packages
-      updateBuilders.push((model: RLCModel) => buildWarpConfig(model, modularPackageInfo));
+      updateBuilders.push((model: ClientModel) => buildWarpConfig(model, modularPackageInfo));
+
+      // Re-sync tsconfig.src.*.json `include` with the warp exports
+      updateBuilders.push(() => buildTsSrcEsmConfig(modularPackageInfo["exports"]));
+      updateBuilders.push(() => buildTsSrcBrowserConfig(modularPackageInfo["exports"]));
+      if (option.generateReactNativeTarget) {
+        updateBuilders.push(() => buildTsSrcReactNativeConfig(modularPackageInfo["exports"]));
+      }
+      updateBuilders.push(() => buildTsSrcCjsConfig(modularPackageInfo["exports"]));
 
       // If the client name changed, regenerate the README and snippets completely;
       // otherwise update only the API reference link in-place.
       if (hasReadmeFile) {
         const readmeSourceFile = await host.readFile(existingReadmeFilePath);
         const existingReadmeContent = readmeSourceFile.text;
-        const clientNameChanged = hasClientNameChanged(rlcClient, existingReadmeContent);
+        const clientNameChanged = hasClientNameChanged(clientModel, existingReadmeContent);
         updateBuilders.push(
           clientNameChanged
             ? buildReadmeFile
-            : (model: RLCModel) => updateReadmeFile(model, existingReadmeContent),
+            : (model: ClientModel) => updateReadmeFile(model, existingReadmeContent),
         );
 
         // Regenerate snippets.spec.ts only when the client name changed
         if (clientNameChanged) {
           for (const subClient of dpgContext.sdkPackage.clients) {
-            updateBuilders.push((model: RLCModel) =>
+            updateBuilders.push((model: ClientModel) =>
               buildSnippets(model, getClassicalClientName(subClient)),
             );
           }
@@ -570,14 +567,14 @@ export async function $onEmit(context: EmitContext) {
       await emitContentByBuilder(
         program,
         updateBuilders,
-        rlcClient,
+        clientModel,
         dpgContext.generationPathDetail?.metadataDir,
       );
     }
     await emitContentByBuilder(
       program,
       buildMetadataJson,
-      rlcClient,
+      clientModel,
       dpgContext.generationPathDetail?.metadataDir,
     );
 
@@ -586,7 +583,7 @@ export async function $onEmit(context: EmitContext) {
       await emitContentByBuilder(
         program,
         [buildRecordedClientFile, buildSampleTest],
-        rlcClient,
+        clientModel,
         dpgContext.generationPathDetail?.metadataDir,
       );
     }

package/src/{rlc-common/interfaces.ts → interfaces.ts}

@@ -1,11 +1,11 @@
 // Copyright (c) Microsoft Corporation.
 // Licensed under the MIT License.
-export interface RLCModel {
+export interface ClientModel {
   libraryName: string;
   srcPath: string;
   paths: Paths;
   importInfo: ImportInfo;
-  options?: RLCOptions;
+  options?: ClientOptions;
   schemas: Schema[];
   apiVersionInfo?: ApiVersionInfo;
   parameters?: OperationParameter[];
@@ -13,8 +13,8 @@ export interface RLCModel {
   helperDetails?: HelperFunctionDetails;
   urlInfo?: UrlInfo;
   telemetryOptions?: TelemetryInfo;
-  sampleGroups?: RLCSampleGroup[];
-  rlcSourceDir?: string;
+  sampleGroups?: SampleGroup[];
+  sourceDir?: string;
 }
 
 export interface ImportInfo {
@@ -28,10 +28,10 @@ export type ImportType =
   /**inner models' imports for parameter and response */
   | "parameter"
   | "response"
-  | "rlcIndex"
+  | "index"
   | "modularModel"
-  | "rlcClientFactory"
-  | "rlcClientDefinition"
+  | "clientFactory"
+  | "clientDefinition"
   /**common third party imports */
   | "restClient"
   | "coreAuth"
@@ -60,18 +60,18 @@ export interface ImportMetadata {
 /**
  * A group of samples in operation_id level and they are used to generate in a sample file
  */
-export interface RLCSampleGroup {
+export interface SampleGroup {
   filename: string;
   clientPackageName: string;
   defaultFactoryName: string;
-  samples: RLCSampleDetail[];
+  samples: SampleDetail[];
   importedTypes?: string[];
 }
 
 /**
  * An independent sample detail and it will be wrapped as a func
  */
-export interface RLCSampleDetail {
+export interface SampleDetail {
   /**
    * metadata for comments
    */
@@ -190,7 +190,7 @@ export interface OperationLroDetail {
   precedence?: number;
 }
 
-export interface RLCOptions {
+export interface ClientOptions {
   /**
    * Whether to include response headers in the generated response types. If true, the generated response types will include headers as properties.
    */
@@ -223,7 +223,6 @@ export interface RLCOptions {
   generateTest?: boolean;
   generateSample?: boolean;
   azureOutputDirectory?: string;
-  isTypeSpecTest?: boolean;
   serviceInfo?: ServiceInfo;
   azureArm?: boolean;
   enableOperationGroup?: boolean;
@@ -234,7 +233,6 @@ export interface RLCOptions {
   clearOutputFolder?: boolean;
   ignorePropertyNameNormalize?: boolean;
   ignoreEnumMemberNameNormalize?: boolean;
-  compatibilityQueryMultiFormat?: boolean;
   typespecTitleMap?: Record<string, string>;
   hasSubscriptionId?: boolean;
   compatibilityLro?: boolean;
@@ -357,8 +355,8 @@ export interface ParameterMetadatas {
 export interface ParameterBodyMetadata {
   /**
    * In case of formData we'd get multiple properties in body marked as partialBody
-   * If yes, rlc-common would prepare the whole part shape;
-   * usually false in typespec source because rlc-common doesn't have to prepare the whole part shape
+   * If yes, the emitter would prepare the whole part shape;
+   * usually false in typespec source because the emitter doesn't have to prepare the whole part shape
    */
   isPartialBody?: boolean;
   body?: ParameterBodySchema[];
@@ -398,7 +396,7 @@ export type ResponseHeaderSchema = Schema;
 export type ResponseBodySchema = Schema;
 
 export type ContentBuilder = {
-  (model: RLCModel): File | File[] | undefined;
+  (model: ClientModel): File | File[] | undefined;
 };
 
 export type SampleParameterPosition = "client" | "path" | "method";

package/src/lib.ts

@@ -3,9 +3,24 @@
 
 import { createTypeSpecLibrary, JSONSchemaType, paramMessage } from "@typespec/compiler";
 import { Options } from "prettier";
-import { PackageDetails } from "./rlc-common/index.js";
+import { PackageDetails } from "./interfaces.js";
 
 export interface EmitterOptions {
+  /**
+   * Use this flag if you would like to generate the sdk only for a specific version.
+   * Also accepts values `latest` and `all`, or a map from service namespace full name to version for multi-service packages.
+   */
+  "api-version"?: string | Record<string, string>;
+  /**
+   * Specifies the directory where the emitter will look for example files.
+   * Defaults to an `examples` directory located at the project root.
+   */
+  "examples-dir"?: string;
+  /**
+   * Specifies the namespace you want to override for namespaces set in the spec.
+   * With this config, all namespace for the spec types will default to it.
+   */
+  namespace?: string;
   /**
    * Indicates whether to include response headers in the generated response type for modular operations.
    * When set to true, modular operation responses with model or void bodies will have their headers
@@ -39,7 +54,6 @@ export interface EmitterOptions {
    */
   "generate-test"?: boolean;
   "generate-sample"?: boolean;
-  "is-typespec-test"?: boolean;
   "azure-arm"?: boolean;
   "enable-operation-group"?: boolean;
   "enable-model-namespace"?: boolean;
@@ -49,11 +63,8 @@ export interface EmitterOptions {
   "experimental-extensible-enums"?: boolean;
   "clear-output-folder"?: boolean;
   "ignore-property-name-normalize"?: boolean;
-  "compatibility-query-multi-format"?: boolean;
   "typespec-title-map"?: Record<string, string>;
   "ignore-enum-member-name-normalize"?: boolean;
-  //TODO should remove this after finish the release tool test
-  "should-use-pnpm-dep"?: boolean;
   "ignore-nullable-on-optional"?: boolean;
   /**
    * When set to true (default for Azure services), non-model return types (arrays, scalars, enums,
@@ -82,10 +93,35 @@ export interface EmitterOptions {
   "generate-react-native-target"?: boolean;
 }
 
-export const RLCOptionsSchema: JSONSchemaType<EmitterOptions> = {
+export const EmitterOptionsSchema: JSONSchemaType<EmitterOptions> = {
   type: "object",
   additionalProperties: true,
   properties: {
+    "api-version": {
+      oneOf: [
+        { type: "string", nullable: true },
+        {
+          type: "object",
+          additionalProperties: { type: "string" },
+          required: [],
+          nullable: true,
+        },
+      ],
+      description:
+        "Use this flag if you would like to generate the sdk only for a specific version. Default value is the latest version. Also accepts values `latest` and `all`. For multi-service packages, provide a map from each service namespace's full name to its desired version; services not listed default to their latest version.",
+    } as any,
+    "examples-dir": {
+      type: "string",
+      nullable: true,
+      description:
+        "Specifies the directory where the emitter will look for example files. If the flag isn't set, the emitter defaults to using an `examples` directory located at the project root.",
+    },
+    namespace: {
+      type: "string",
+      nullable: true,
+      description:
+        "Specifies the namespace you want to override for namespaces set in the spec. With this config, all namespace for the spec types will default to it.",
+    },
     "include-headers-in-response": {
       type: "boolean",
       nullable: true,
@@ -171,11 +207,6 @@ export const RLCOptionsSchema: JSONSchemaType<EmitterOptions> = {
       description:
         "Whether to generate sample files, for basic samples of your generated sdks. Defaults to `undefined`. Management packages' default to `true`.",
     },
-    "is-typespec-test": {
-      type: "boolean",
-      nullable: true,
-      description: "Internal option for test",
-    },
     "azure-arm": {
       type: "boolean",
       nullable: true,
@@ -234,12 +265,6 @@ export const RLCOptionsSchema: JSONSchemaType<EmitterOptions> = {
       description:
         "The emitter has a normalization logic for enum member key, to ignore this normalization, you can set this option to true",
     },
-    "compatibility-query-multi-format": {
-      type: "boolean",
-      nullable: true,
-      description:
-        "Whether to generate the backward-compatible code for query parameter serialization for array types in RLC. Defaults to `false`",
-    },
     "typespec-title-map": {
       type: "object",
       additionalProperties: {
@@ -258,11 +283,6 @@ export const RLCOptionsSchema: JSONSchemaType<EmitterOptions> = {
         "```",
       ].join("\n"),
     },
-    "should-use-pnpm-dep": {
-      type: "boolean",
-      nullable: true,
-      description: "Internal option for test.",
-    },
     "ignore-nullable-on-optional": {
       type: "boolean",
       nullable: true,
@@ -561,7 +581,7 @@ const libDef = {
     },
   },
   emitter: {
-    options: RLCOptionsSchema,
+    options: EmitterOptionsSchema,
   },
 } as const;
 

package/src/meta-tree.ts

@@ -1,8 +1,8 @@
 import { Type } from "@typespec/compiler";
-import { Schema as RlcType } from "./rlc-common/index.js";
+import { Schema } from "./interfaces.js";
 
-export interface RlcTypeMetadata {
-  rlcType: RlcType;
+export interface ClientTypeMetadata {
+  clientType: Schema;
 }
 
-export type RlcMetaTree = Map<Type, RlcTypeMetadata>;
+export type ClientTypeMetaTree = Map<Type, ClientTypeMetadata>;