October 2022

This release contains breaking changes:

• TypeSpec: Cannot extends or is a model expression via alias
• Api: Removed createProgram and changed compile parameter order
• TypeSpec Deprecation @service decorator replacing @serviceTitle and @serviceVersion
• TypeSpec Api: Move @discriminator to compiler

[TypeSpec] Cannot extends or is a model expression via alias PR 1004

Using model expression for is or extends directly was already forbidden.

model IsModelExpr is {bar: string} {}

model ExtendsModelExpr extends {bar: string} {}

The following workaround was however tolerated. This PR remove this functionality.

alias ModExpr = {bar: string};
model IsModelExprWAlias is ModExpr {}

model ExtendsModelExprWAlias extends ModExpr {}

Use a named model instead of an alias.

[API] Removed createProgram and changed compile parameter order

createProgram has been removed in favor of compile. The new compile has the same parameter as createProgram

// Before
createProgram(host, "main.tsp);

// After
compile(host, "main.tsp");

compile api was changed to match the same order as old createProggram

// Before
compile("main.tsp", host);

// After
compile(host, "main.tsp");

[TypeSpec] Deprecation: @service decorator replacing @serviceTitle and @serviceVersion

• @serviceTitle has been deprecated
• @serviceVersion has been deprecated

// Before
@serviceTitle("Pet Store")
@serviceVersion("v1")
namespace PetStore;

// After
@service(#{"Pet Store", version: "v1"})
namespace PetStore;

This allows to specify the service namespace without any title or version

@service
namespace PetStore;

[TypeSpec] [Api] Move @discriminator to compiler

The @discriminator has been moved to the compiler. This means that if you were using the fully qualified name to reference the decorator @TypeSpec.Rest.disriminator it should be changed to @discriminator

No changes

using Rest;

@disriminator("kind")
model Pet {}

Before

@TypeSpec.Rest.disriminator("kind")
model Pet {}

After

@disriminator("kind")
model Pet {}

Change to api

the getDiscriminator accessor has also been removed into the compiler.

Before

import { getDiscriminator } from "@typespec/rest";

After

import { getDiscriminator } from "@typespec/compiler";