@azure-tools/typespec-ts 0.33.0 → 0.34.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@azure-tools/typespec-ts",
-  "version": "0.33.0",
+  "version": "0.34.0",
   "description": "An experimental TypeSpec emitter for TypeScript RLC",
   "main": "dist/src/index.js",
   "type": "module",
@@ -17,18 +17,18 @@
   "author": "Jose Heredia <joheredi@microsoft.com>",
   "license": "MIT",
   "devDependencies": {
-    "@azure-rest/core-client": "^2.1.0",
-    "@azure-tools/cadl-ranch-expect": "^0.15.1",
-    "@azure-tools/cadl-ranch-specs": "^0.36.1",
-    "@azure-tools/cadl-ranch": "^0.14.3",
-    "@azure-tools/cadl-ranch-api": "^0.4.6",
-    "@azure-tools/typespec-autorest": ">=0.45.0 <1.0.0",
-    "@azure-tools/typespec-azure-core": ">=0.45.0 <1.0.0",
-    "@azure-tools/typespec-azure-resource-manager": ">=0.45.0 <1.0.0",
-    "@azure-tools/typespec-client-generator-core": ">=0.45.4 <1.0.0",
+    "@azure-rest/core-client": "^2.3.1",
+    "@azure-tools/cadl-ranch-expect": "^0.15.5",
+    "@azure-tools/cadl-ranch-specs": "^0.38.0",
+    "@azure-tools/cadl-ranch": "^0.15.0",
+    "@azure-tools/cadl-ranch-api": "^0.5.0",
+    "@azure-tools/typespec-autorest": ">=0.47.0 <1.0.0",
+    "@azure-tools/typespec-azure-core": ">=0.47.0 <1.0.0",
+    "@azure-tools/typespec-azure-resource-manager": ">=0.47.0 <1.0.0",
+    "@azure-tools/typespec-client-generator-core": ">=0.47.4 <1.0.0",
     "@azure/abort-controller": "^2.1.2",
     "@azure/core-auth": "^1.6.0",
-    "@azure/core-lro": "^3.0.0",
+    "@azure/core-lro": "^3.1.0",
     "@azure/core-paging": "^1.5.0",
     "@azure/core-rest-pipeline": "^1.14.0",
     "@azure/core-util": "^1.4.0",
@@ -40,12 +40,12 @@
     "@types/node": "^18.0.0",
     "@typescript-eslint/eslint-plugin": "^6.8.0",
     "@typescript-eslint/parser": "^6.8.0",
-    "@typespec/compiler": ">=0.59.0 <1.0.0",
-    "@typespec/http": ">=0.59.0 <1.0.0",
-    "@typespec/openapi": ">=0.59.0, <1.0.0",
-    "@typespec/rest": ">=0.59.0 <1.0.0",
+    "@typespec/compiler": ">=0.61.2 <1.0.0",
+    "@typespec/http": ">=0.61.0 <1.0.0",
+    "@typespec/openapi": ">=0.61.0, <1.0.0",
+    "@typespec/rest": ">=0.61.0 <1.0.0",
     "@typespec/ts-http-runtime": "1.0.0-alpha.20240314.2",
-    "@typespec/versioning": ">=0.59.0 <1.0.0",
+    "@typespec/versioning": ">=0.61.0 <1.0.0",
     "chai": "^4.3.6",
     "chalk": "^4.0.0",
     "cross-env": "^7.0.3",
@@ -54,10 +54,10 @@
     "mkdirp": "^3.0.1",
     "mocha": "^10.4.0",
     "npm-run-all": "~4.1.5",
-    "prettier": "^3.1.0",
+    "prettier": "^3.3.3",
     "rimraf": "^5.0.0",
     "ts-node": "~10.9.1",
-    "typescript": "~5.5.3",
+    "typescript": "~5.6.2",
     "vitest": "~1.6.0",
     "@vitest/coverage-v8": "~1.6.0",
     "@vitest/coverage-istanbul": "~1.6.0",
@@ -65,18 +65,18 @@
     "tsx": "^4.16.5"
   },
   "peerDependencies": {
-    "@azure-tools/typespec-azure-core": ">=0.45.0 <1.0.0",
-    "@azure-tools/typespec-client-generator-core": ">=0.45.4 <1.0.0",
-    "@typespec/compiler": ">=0.59.0 <1.0.0",
-    "@typespec/http": ">=0.59.0 <1.0.0",
-    "@typespec/rest": ">=0.59.0 <1.0.0",
-    "@typespec/versioning": ">=0.59.0 <1.0.0"
+    "@azure-tools/typespec-azure-core": ">=0.47.0 <1.0.0",
+    "@azure-tools/typespec-client-generator-core": ">=0.47.4 <1.0.0",
+    "@typespec/compiler": ">=0.61.2 <1.0.0",
+    "@typespec/http": ">=0.61.0 <1.0.0",
+    "@typespec/rest": ">=0.61.0 <1.0.0",
+    "@typespec/versioning": ">=0.61.0 <1.0.0"
   },
   "dependencies": {
-    "@azure-tools/rlc-common": "^0.33.0",
+    "@azure-tools/rlc-common": "^0.34.0",
     "fs-extra": "^11.1.0",
     "lodash": "^4.17.21",
-    "prettier": "^3.1.0",
+    "prettier": "^3.3.3",
     "ts-morph": "^23.0.0",
     "tslib": "^2.3.1"
   },

package/src/framework/declaration.ts

@@ -71,7 +71,6 @@ export function addDeclaration(
   }
 
   const stringRefkey = typeof refkey === "string" ? refkey : getRefKey(refkey);
-
   const trackedDeclarationName = binder.trackDeclaration(
     stringRefkey,
     declaration.name,

package/src/framework/dependency.ts

@@ -26,6 +26,11 @@ export interface CoreDependencies extends Record<string, ReferenceableSymbol> {
     name: "OperationOptions";
     module: string;
   };
+  StreamableMethod: {
+    kind: "externalDependency";
+    name: "StreamableMethod";
+    module: string;
+  };
   PathUncheckedResponse: {
     kind: "externalDependency";
     name: "PathUncheckedResponse";
@@ -56,6 +61,26 @@ export interface CoreDependencies extends Record<string, ReferenceableSymbol> {
     name: "stringToUint8Array";
     module: string;
   };
+  isKeyCredential: {
+    kind: "externalDependency";
+    name: "isKeyCredential";
+    module: string;
+  };
+  KeyCredential: {
+    kind: "externalDependency";
+    name: "KeyCredential";
+    module: string;
+  };
+  TokenCredential: {
+    kind: "externalDependency";
+    name: "TokenCredential";
+    module: string;
+  };
+  ErrorModel: {
+    kind: "externalDependency";
+    name: "ErrorModel";
+    module: string;
+  };
 }
 
 export type CoreDependency = keyof CoreDependencies;

package/src/framework/hooks/binder.ts

@@ -14,6 +14,8 @@ import {
   SourceFileSymbol,
   StaticHelperMetadata
 } from "../load-static-helpers.js";
+import path from "path/posix";
+import { normalizePath } from "@typespec/compiler";
 
 export interface DeclarationInfo {
   name: string;
@@ -40,10 +42,10 @@ export interface Binder {
     sourceFile: SourceFile
   ): string;
   resolveReference(refkey: unknown): string;
-  resolveAllReferences(): void;
+  resolveAllReferences(sourceRoot: string): void;
 }
 
-const PLACEHOLDER_PREFIX = "_PLACEHOLDER_";
+const PLACEHOLDER_PREFIX = "__PLACEHOLDER_";
 
 class BinderImp implements Binder {
   private declarations = new Map<unknown, DeclarationInfo>();
@@ -157,7 +159,7 @@ class BinderImp implements Binder {
    * @returns The serialized placeholder string.
    */
   private serializePlaceholder(refkey: unknown): string {
-    return `${PLACEHOLDER_PREFIX}${String(refkey)}_`;
+    return `${PLACEHOLDER_PREFIX}${String(refkey)}__`;
   }
 
   /**
@@ -222,19 +224,19 @@ class BinderImp implements Binder {
   /**
    * Applies all tracked imports to their respective source files.
    */
-  resolveAllReferences(): void {
-    for (const file of this.project.getSourceFiles()) {
+  resolveAllReferences(sourceRoot: string): void {
+    this.project.getSourceFiles().map((file) => {
       this.resolveDeclarationReferences(file);
       this.resolveDependencyReferences(file);
-    }
-
-    for (const [sourceFile, importStructures] of this.imports) {
-      for (const importStructure of importStructures) {
-        sourceFile.addImportDeclaration(importStructure);
+      const importStructures = this.imports.get(file);
+      if (importStructures) {
+        for (const importStructure of importStructures) {
+          file.addImportDeclaration(importStructure);
+        }
       }
-    }
+    });
 
-    this.cleanUnreferencedHelpers();
+    this.cleanUnreferencedHelpers(sourceRoot);
   }
 
   private resolveDependencyReferences(file: SourceFile) {
@@ -296,7 +298,7 @@ class BinderImp implements Binder {
     this.references.get(refkey)!.add(sourceFile);
   }
 
-  private cleanUnreferencedHelpers() {
+  private cleanUnreferencedHelpers(sourceRoot: string) {
     const usedHelperFiles = new Set<SourceFile>();
     for (const helper of this.staticHelpers.values()) {
       const sourceFile = helper[SourceFileSymbol];
@@ -314,7 +316,10 @@ class BinderImp implements Binder {
     }
 
     this.project
-      .getSourceFiles("**/static-helpers/**/*.ts")
+      //normalizae the final path to adapt to different systems
+      .getSourceFiles(
+        normalizePath(path.join(sourceRoot, "static-helpers/**/*.ts"))
+      )
       .filter((helperFile) => !usedHelperFiles.has(helperFile))
       .forEach((helperFile) => helperFile.delete());
   }

package/src/framework/hooks/sdkTypes.ts

@@ -1,14 +1,18 @@
+import { Operation, Type, getNamespaceFullName } from "@typespec/compiler";
 import {
   SdkClientType,
   SdkHttpOperation,
-  SdkPackage,
   SdkServiceMethod,
   SdkType,
   getClientType
 } from "@azure-tools/typespec-client-generator-core";
-import { Operation, Type, getNamespaceFullName } from "@typespec/compiler";
 import { provideContext, useContext } from "../../contextManager.js";
 
+import { visitPackageTypes } from "../../modular/emitModels.js";
+import { SdkContext } from "../../utils/interfaces.js";
+
+export const emitQueue: Set<SdkType> = new Set<SdkType>();
+
 export interface SdkTypeContext {
   operations: Map<Type, SdkServiceMethod<SdkHttpOperation>>;
   types: Map<Type, SdkType>;
@@ -50,25 +54,56 @@ export function useSdkTypes() {
   return getSdkType;
 }
 
-export function provideSdkTypes(sdkPackage: SdkPackage<SdkHttpOperation>) {
+export function provideSdkTypes(context: SdkContext) {
+  const { sdkPackage } = context;
   const sdkTypesContext = {
     operations: new Map<Type, SdkServiceMethod<SdkHttpOperation>>(),
     types: new Map<Type, SdkType>()
   };
-
-  for (const sdkEnum of sdkPackage.enums) {
-    if (!sdkEnum.__raw) {
-      continue;
+  visitPackageTypes(context);
+  for (const sdkModel of emitQueue) {
+    switch (sdkModel.kind) {
+      case "model":
+        sdkModel.properties.forEach((prop) => {
+          sdkTypesContext.types.set(prop.type.__raw!, prop.type);
+        });
+        if (sdkModel.discriminatedSubtypes) {
+          Object.values(sdkModel.discriminatedSubtypes).forEach((subtype) => {
+            sdkTypesContext.types.set(subtype.__raw!, subtype);
+          });
+        }
+        break;
+      case "enum":
+        if (sdkModel.__raw) {
+          sdkTypesContext.types.set(sdkModel.__raw, sdkModel);
+        }
+        break;
+      case "union":
+        sdkModel.variantTypes.forEach((v) => {
+          if (v.__raw) {
+            sdkTypesContext.types.set(v.__raw, v);
+          }
+        });
+        break;
+      case "array":
+        sdkTypesContext.types.set(
+          sdkModel.valueType.__raw!,
+          sdkModel.valueType
+        );
+        break;
+      case "dict":
+        sdkTypesContext.types.set(
+          sdkModel.valueType.__raw!,
+          sdkModel.valueType
+        );
+        break;
+      case "nullable":
+        sdkTypesContext.types.set(sdkModel.type.__raw!, sdkModel.type);
+        break;
     }
-
-    sdkTypesContext.types.set(sdkEnum.__raw, sdkEnum);
-  }
-
-  for (const sdkModel of sdkPackage.models) {
     if (!sdkModel.__raw) {
       continue;
     }
-
     sdkTypesContext.types.set(sdkModel.__raw, sdkModel);
   }
 
@@ -79,6 +114,11 @@ export function provideSdkTypes(sdkPackage: SdkPackage<SdkHttpOperation>) {
       }
 
       sdkTypesContext.operations.set(method.__raw, method);
+
+      // Visit the parameters of the method to add them to the types map
+      method.parameters.forEach((param) => {
+        sdkTypesContext.types.set(param.type.__raw!, param.type);
+      });
     }
   }
 

package/src/framework/refkey.ts

@@ -24,5 +24,5 @@ function getKey(value: unknown): RefKey {
 }
 
 export function refkey(...args: unknown[]) {
-  return args.map((v) => getKey(v)).join("\u2063");
+  return args.map((v) => getKey(v)).join("_");
 }

package/src/framework/sample.ts

@@ -67,7 +67,7 @@ sourceFile2.addStatements(`${functionReference}();`);
 sourceFile2.addStatements(`let obj: ${modelReference} = { id: 1 };`);
 
 // Apply imports to ensure correct references
-binder.resolveAllReferences();
+binder.resolveAllReferences("/modularPackageFolder/src");
 
 // Output the generated files
 console.log("// test.ts");

package/src/index.ts

@@ -2,9 +2,9 @@
 // Licensed under the MIT License.
 
 import * as fsextra from "fs-extra";
-
 import {
   AzureCoreDependencies,
+  AzureIdentityDependencies,
   AzurePollingDependencies,
   DefaultCoreDependencies
 } from "./modular/external-dependencies.js";
@@ -44,9 +44,9 @@ import {
   getClientName,
   hasUnexpectedHelper,
   isAzurePackage,
-  updatePackageFile
+  updatePackageFile,
+  buildSampleEnvFile
 } from "@azure-tools/rlc-common";
-import { buildModels, buildModelsOptions } from "./modular/emitModels.js";
 import {
   buildRootIndex,
   buildSubClientIndexFile
@@ -56,19 +56,22 @@ import { provideContext, useContext } from "./contextManager.js";
 
 import { EmitterOptions } from "./lib.js";
 import { ModularCodeModel } from "./modular/modularCodeModel.js";
-import { Project } from "ts-morph";
+import { Project, SourceFile } from "ts-morph";
 import { buildClassicOperationFiles } from "./modular/buildClassicalOperationGroups.js";
 import { buildClassicalClient } from "./modular/buildClassicalClient.js";
-import { buildClientContext } from "./modular/buildClientContext.js";
+import {
+  getClientContextPath,
+  buildClientContext
+} from "./modular/buildClientContext.js";
+import { buildApiOptions } from "./modular/emitModelsOptions.js";
 import { buildOperationFiles } from "./modular/buildOperations.js";
 import { buildRestorePoller } from "./modular/buildRestorePoller.js";
-import { buildSerializeUtils } from "./modular/buildSerializeUtils.js";
 import { buildSubpathIndexFile } from "./modular/buildSubpathIndex.js";
 import { createSdkContext } from "@azure-tools/typespec-client-generator-core";
 import { emitCodeModel } from "./modular/buildCodeModel.js";
 import { emitLoggerFile } from "./modular/emitLoggerFile.js";
 import { emitSerializerHelpersFile } from "./modular/buildHelperSerializers.js";
-import { env } from "process";
+import { emitTypes } from "./modular/emitModels.js";
 import { existsSync } from "fs";
 import { getModuleExports } from "./modular/buildProjectFiles.js";
 import { getRLCClients } from "./utils/clientUtils.js";
@@ -78,6 +81,7 @@ import { provideBinder } from "./framework/hooks/binder.js";
 import { provideSdkTypes } from "./framework/hooks/sdkTypes.js";
 import { transformRLCModel } from "./transform/transform.js";
 import { transformRLCOptions } from "./transform/transfromRLCOptions.js";
+import { emitSamples } from "./modular/emitSamples.js";
 
 export * from "./lib.js";
 
@@ -105,7 +109,6 @@ export async function $onEmit(context: EmitContext) {
     compilerContext: context,
     tcgcContext: dpgContext
   });
-  provideSdkTypes(dpgContext.sdkPackage);
   const { modularSourcesDir } = await calculateGenerationDir(rlcOptions);
   const staticHelpers = await loadStaticHelpers(
     outputProject,
@@ -117,7 +120,11 @@ export async function $onEmit(context: EmitContext) {
     { sourcesDir: modularSourcesDir }
   );
   const extraDependencies = isAzurePackage({ options: rlcOptions })
-    ? { ...AzurePollingDependencies, ...AzureCoreDependencies }
+    ? {
+        ...AzurePollingDependencies,
+        ...AzureCoreDependencies,
+        ...AzureIdentityDependencies
+      }
     : { ...DefaultCoreDependencies };
   const binder = provideBinder(outputProject, {
     staticHelpers,
@@ -125,6 +132,7 @@ export async function $onEmit(context: EmitContext) {
       ...extraDependencies
     }
   });
+  provideSdkTypes(dpgContext);
 
   const rlcCodeModels: RLCModel[] = [];
   let modularCodeModel: ModularCodeModel;
@@ -259,27 +267,33 @@ export async function $onEmit(context: EmitContext) {
 
     const isMultiClients = modularCodeModel.clients.length > 1;
 
+    emitTypes(dpgContext, { sourceRoot: modularSourcesRoot });
+    buildSubpathIndexFile(modularCodeModel, "models");
+    // Enable modular sample generation when explicitly set to true or MPG
+    if (emitterOptions?.generateSample === 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;
+      }
+    }
     for (const subClient of modularCodeModel.clients) {
-      buildModels(subClient, modularCodeModel);
-      buildModelsOptions(subClient, modularCodeModel);
-      if (!env["EXPERIMENTAL_TYPESPEC_TS_SERIALIZATION"])
-        buildSerializeUtils(modularCodeModel);
-      // build operation files
+      buildApiOptions(dpgContext, subClient, modularCodeModel);
       buildOperationFiles(subClient, dpgContext, modularCodeModel);
       buildClientContext(subClient, dpgContext, modularCodeModel);
-      buildSubpathIndexFile(subClient, modularCodeModel, "models");
       buildRestorePoller(modularCodeModel, subClient);
       if (dpgContext.rlcOptions?.hierarchyClient) {
-        buildSubpathIndexFile(subClient, modularCodeModel, "api");
+        buildSubpathIndexFile(modularCodeModel, "api", subClient);
       } else {
-        buildSubpathIndexFile(subClient, modularCodeModel, "api", {
+        buildSubpathIndexFile(modularCodeModel, "api", subClient, {
           exportIndex: true
         });
       }
 
       buildClassicalClient(subClient, dpgContext, modularCodeModel);
       buildClassicOperationFiles(dpgContext, modularCodeModel, subClient);
-      buildSubpathIndexFile(subClient, modularCodeModel, "classic", {
+      buildSubpathIndexFile(modularCodeModel, "classic", subClient, {
         exportIndex: true,
         interfaceOnly: true
       });
@@ -289,10 +303,19 @@ export async function $onEmit(context: EmitContext) {
       buildRootIndex(subClient, modularCodeModel, rootIndexFile);
     }
 
-    binder.resolveAllReferences();
+    binder.resolveAllReferences(modularSourcesRoot);
 
     for (const file of project.getSourceFiles()) {
-      file.fixMissingImports({}, { importModuleSpecifierEnding: "js" });
+      file.fixMissingImports(
+        {},
+        {
+          importModuleSpecifierEnding: "js",
+          importModuleSpecifierPreference: "relative",
+          includePackageJsonAutoImports: "off",
+          excludeLibrarySymbolsInNavTo: true
+        }
+      );
+      await removeUnusedImports(file);
       file.fixUnusedIdentifiers();
       await emitContentByBuilder(
         program,
@@ -303,6 +326,7 @@ export async function $onEmit(context: EmitContext) {
   }
 
   async function generateMetadataAndTest() {
+    const project = useContext("outputProject");
     if (rlcCodeModels.length === 0 || !rlcCodeModels[0]) {
       return;
     }
@@ -323,7 +347,8 @@ export async function $onEmit(context: EmitContext) {
         buildRollupConfig,
         buildApiExtractorConfig,
         buildReadmeFile,
-        buildLicenseFile
+        buildLicenseFile,
+        buildSampleEnvFile
       ];
       if (option.moduleKind === "esm") {
         commonBuilders.push((model) => buildVitestConfig(model, "node"));
@@ -343,7 +368,8 @@ export async function $onEmit(context: EmitContext) {
             ...modularPackageInfo,
             dependencies: {
               "@azure/core-util": "^1.9.2"
-            }
+            },
+            clientContextPaths: getRelativeContextPaths(modularCodeModel)
           };
         }
       }
@@ -360,7 +386,6 @@ export async function $onEmit(context: EmitContext) {
       );
 
       if (option.isModularLibrary) {
-        const project = useContext("outputProject");
         for (const file of project.getSourceFiles()) {
           await emitContentByBuilder(
             program,
@@ -389,15 +414,52 @@ export async function $onEmit(context: EmitContext) {
       );
     }
   }
+
+  function getRelativeContextPaths(codeModel: ModularCodeModel) {
+    return codeModel.clients
+      .map((subClient) => getClientContextPath(subClient, codeModel))
+      .map((path) => path.substring(path.indexOf("src")));
+  }
+}
+
+export async function removeUnusedImports(file: SourceFile) {
+  file.getImportDeclarations().map((importDeclaration) => {
+    importDeclaration.getFullText();
+    importDeclaration.getNamedImports().map((namedImport) => {
+      namedImport.getFullText();
+      if (
+        namedImport
+          .getNameNode()
+          .findReferencesAsNodes()
+          .filter((n) => {
+            return n.getSourceFile().getFilePath() === file.getFilePath();
+          }).length === 1
+      ) {
+        namedImport.remove();
+      }
+    });
+    if (importDeclaration.getNamedImports().length === 0) {
+      importDeclaration.remove();
+    }
+  });
+  file.getExportDeclarations().map((exportDeclaration) => {
+    if (exportDeclaration.getNamedExports().length === 0) {
+      exportDeclaration.remove();
+    }
+  });
 }
 
 export async function createContextWithDefaultOptions(
   context: EmitContext<Record<string, any>>
 ): Promise<SdkContext> {
+  const flattenUnionAsEnum =
+    context.options["experimentalExtensibleEnums"] === undefined
+      ? isArm(context)
+      : context.options["experimentalExtensibleEnums"];
   const tcgcSettings = {
     "generate-protocol-methods": true,
     "generate-convenience-methods": true,
-    "flatten-union-as-enum": false,
+    "flatten-union-as-enum": flattenUnionAsEnum,
     emitters: [
       {
         main: "@azure-tools/typespec-ts",
@@ -410,5 +472,14 @@ export async function createContextWithDefaultOptions(
     ...tcgcSettings
   };
 
-  return (await createSdkContext(context)) as SdkContext;
+  return (await createSdkContext(
+    context,
+    context.program.emitters[0]?.metadata.name ?? "@azure-tools/typespec-ts"
+  )) as SdkContext;
+}
+
+// TODO: should be removed once tcgc issue is resolved https://github.com/Azure/typespec-azure/issues/1794
+function isArm(context: EmitContext<Record<string, any>>) {
+  const packageName = (context?.options["packageDetails"] ?? {})["name"] ?? "";
+  return packageName?.startsWith("@azure/arm-");
 }

package/src/lib.ts

@@ -11,8 +11,6 @@ import { Options } from "prettier";
 
 export interface EmitterOptions extends RLCOptions {
   branded?: boolean;
-  compatibilityMode?: boolean;
-  experimentalExtensibleEnums?: boolean;
 }
 
 export const RLCOptionsSchema: JSONSchemaType<EmitterOptions> = {
@@ -93,7 +91,8 @@ export const RLCOptionsSchema: JSONSchemaType<EmitterOptions> = {
     },
     compatibilityMode: { type: "boolean", nullable: true },
     experimentalExtensibleEnums: { type: "boolean", nullable: true },
-    clearOutputFolder: { type: "boolean", nullable: true }
+    clearOutputFolder: { type: "boolean", nullable: true },
+    ignorePropertyNameNormalize: { type: "boolean", nullable: true }
   },
   required: []
 };
@@ -244,6 +243,30 @@ const libDef = {
       messages: {
         default: paramMessage`Authentication type ${"credentialType"} is not supported.`
       }
+    },
+    "un-supported-finalStateVia": {
+      severity: "warning",
+      messages: {
+        default: paramMessage`The LRO final-state-via ${"finalStateVia"} is not supported.`
+      }
+    },
+    "required-sample-parameter": {
+      severity: "warning",
+      messages: {
+        default: paramMessage`The parameter ${"paramName"} in ${"exampleName"} is required but no value provided.`
+      }
+    },
+    "property-name-normalized": {
+      severity: "warning",
+      messages: {
+        default: paramMessage`Property name ${"propertyName"} is normalized to ${"normalizedName"}.`
+      }
+    },
+    "optional-path-param": {
+      severity: "error",
+      messages: {
+        default: paramMessage`Path parameter '${"paramName"}' cannot be optional.`
+      }
     }
   },
   emitter: {