Refactor the sample generation into rlc-common & Generate samples with mock content

[MaryGao]

fixes #2000

The pr is mainly focusing on generating samples if no real examples provided. Here is the high-level design:

rlc-common

• transformSampleGroups.ts

In common layer we provide a transform function which could generate sample content based on path/schema/operation details in RLCModel. Currently we only provide mock value generation which could be improved if we have suggested values in future.

export function transformSampleGroups(model: RLCModel, allowMockValue = true)

• valueGenerationUtil.ts

Helper functions to help generate values, the idea here is to try to suggest the ts-type from schema, if can't we will fallback to suggest ts-type from the generated type iteself, e.g Record<string, "test" | 1> would be a record type.

export function generateParameterTypeValue(
  type: string,
  parameterName: string,
  schemaMap: Map<string, Schema>,
  path: Set<string> = new Set(),
  _allowMockValue = true
)

• typeUtil.ts

Helper utils to detect the detailed ts types.

typespec-ts

The only thing in typespec project needs to do is apply the common transform logic and small improvements in schema for better detection.

model.sampleGroups = transformSampleGroups(
    model,
    options?.generateSample ===
      true /* Enable mock sample content if generateSample === true */
  );

autorest.typescript

• rlcSampleGenerator.ts

We prefer to generate sample from swagger examples first and if no swagger examples, we will generate mock sample.

Testing

• rlc-common/test/helpers/typeUtil.spec.ts testing for different type convertion
• typespec-ts/test/unit/transform/transformSchemas.spec.ts testing for distinct schema data
• typespec-ts/test/unit/sample/generateSampleContent.spec.ts integration testing from typespec to generated values
• smoke testing both in swagger and typespec

[qiaozha]

leave some comments

[qiaozha]

LGTM, just some minor comments

[qiaozha]

Just a little curious about the priority between ? and ??. should we use parentheses to be explicit here ?

[MaryGao]

The priority should be good if i added parentheses explicitly the formatter would remove them automatically.

parameters.method.length > 0 ? (parameters.method[0].value ?? "") : "";

I mean something like true[] or 12[] or "test"[]

updated.

[qiaozha]

LGTM, just some minor comments