@typespec/versioning 0.57.0-dev.5 → 0.57.0-dev.6

package/lib/decorators.tsp

@@ -1,224 +1,192 @@
-import "../dist/src/versioning.js";
+import "../dist/src/decorators.js";
 
 using TypeSpec.Reflection;
 
-namespace TypeSpec {
-  namespace Versioning {
-    /**
-     * Identifies that the decorated namespace is versioned by the provided enum.
-     * @param versions The enum that describes the supported versions.
-     *
-     * @example
-     *
-     * ```tsp
-     * @versioned(Versions)
-     * namespace MyService;
-     * enum Versions {
-     *   v1,
-     *   v2,
-     *   v3,
-     * }
-     * ```
-     */
-    extern dec versioned(target: Namespace, versions: Enum);
+namespace TypeSpec.Versioning;
 
-    /**
-     * Identifies that a namespace or a given versioning enum member relies upon a versioned package.
-     * @param versionRecords The dependent library version(s) for the target namespace or version.
-     *
-     * @example Select a single version of `MyLib` to use
-     *
-     * ```tsp
-     * @useDependency(MyLib.Versions.v1_1)
-     * namespace NonVersionedService;
-     * ```
-     *
-     * @example Select which version of the library match to which version of the service.
-     *
-     * ```tsp
-     * @versioned(Versions)
-     * namespace MyService1;
-     * enum Version {
-     *   @useDependency(MyLib.Versions.v1_1) // V1 use lib v1_1
-     *   v1,
-     *   @useDependency(MyLib.Versions.v1_1) // V2 use lib v1_1
-     *   v2,
-     *   @useDependency(MyLib.Versions.v2) // V3 use lib v2
-     *   v3,
-     * }
-     * ```
-     */
-    extern dec useDependency(target: EnumMember | Namespace, ...versionRecords: EnumMember[]);
+/**
+ * Identifies that the decorated namespace is versioned by the provided enum.
+ * @param versions The enum that describes the supported versions.
+ *
+ * @example
+ *
+ * ```tsp
+ * @versioned(Versions)
+ * namespace MyService;
+ * enum Versions {
+ *   v1,
+ *   v2,
+ *   v3,
+ * }
+ * ```
+ */
+extern dec versioned(target: Namespace, versions: Enum);
 
-    /**
-     * Identifies when the target was added.
-     * @param version The version that the target was added in.
-     *
-     * @example
-     *
-     * ```tsp
-     * @added(Versions.v2)
-     * op addedInV2(): void;
-     *
-     * @added(Versions.v2)
-     * model AlsoAddedInV2 {}
-     *
-     * model Foo {
-     *   name: string;
-     *
-     *   @added(Versions.v3)
-     *   addedInV3: string;
-     * }
-     * ```
-     */
-    extern dec added(
-      target:
-        | Model
-        | ModelProperty
-        | Operation
-        | Enum
-        | EnumMember
-        | Union
-        | UnionVariant
-        | Scalar
-        | Interface,
-      version: EnumMember
-    );
+/**
+ * Identifies that a namespace or a given versioning enum member relies upon a versioned package.
+ * @param versionRecords The dependent library version(s) for the target namespace or version.
+ *
+ * @example Select a single version of `MyLib` to use
+ *
+ * ```tsp
+ * @useDependency(MyLib.Versions.v1_1)
+ * namespace NonVersionedService;
+ * ```
+ *
+ * @example Select which version of the library match to which version of the service.
+ *
+ * ```tsp
+ * @versioned(Versions)
+ * namespace MyService1;
+ * enum Version {
+ *   @useDependency(MyLib.Versions.v1_1) // V1 use lib v1_1
+ *   v1,
+ *   @useDependency(MyLib.Versions.v1_1) // V2 use lib v1_1
+ *   v2,
+ *   @useDependency(MyLib.Versions.v2) // V3 use lib v2
+ *   v3,
+ * }
+ * ```
+ */
+extern dec useDependency(target: EnumMember | Namespace, ...versionRecords: EnumMember[]);
 
-    /**
-     * Identifies when the target was removed.
-     * @param version The version that the target was removed in.
-     *
-     * @example
-     * ```tsp
-     * @removed(Versions.v2)
-     * op removedInV2(): void;
-     *
-     * @removed(Versions.v2)
-     * model AlsoRemovedInV2 {}
-     *
-     * model Foo {
-     *   name: string;
-     *
-     *   @removed(Versions.v3)
-     *   removedInV3: string;
-     * }
-     * ```
-     */
-    extern dec removed(
-      target:
-        | Model
-        | ModelProperty
-        | Operation
-        | Enum
-        | EnumMember
-        | Union
-        | UnionVariant
-        | Scalar
-        | Interface,
-      version: EnumMember
-    );
+/**
+ * Identifies when the target was added.
+ * @param version The version that the target was added in.
+ *
+ * @example
+ *
+ * ```tsp
+ * @added(Versions.v2)
+ * op addedInV2(): void;
+ *
+ * @added(Versions.v2)
+ * model AlsoAddedInV2 {}
+ *
+ * model Foo {
+ *   name: string;
+ *
+ *   @added(Versions.v3)
+ *   addedInV3: string;
+ * }
+ * ```
+ */
+extern dec added(
+  target:
+    | Model
+    | ModelProperty
+    | Operation
+    | Enum
+    | EnumMember
+    | Union
+    | UnionVariant
+    | Scalar
+    | Interface,
+  version: EnumMember
+);
 
-    /**
-     * Identifies when the target has been renamed.
-     * @param version The version that the target was renamed in.
-     * @param oldName The previous name of the target.
-     *
-     * @example
-     * ```tsp
-     * @renamedFrom(Versions.v2, "oldName")
-     * op newName(): void;
-     * ```
-     */
-    extern dec renamedFrom(
-      target:
-        | Model
-        | ModelProperty
-        | Operation
-        | Enum
-        | EnumMember
-        | Union
-        | UnionVariant
-        | Scalar
-        | Interface,
-      version: EnumMember,
-      oldName: valueof string
-    );
+/**
+ * Identifies when the target was removed.
+ * @param version The version that the target was removed in.
+ *
+ * @example
+ * ```tsp
+ * @removed(Versions.v2)
+ * op removedInV2(): void;
+ *
+ * @removed(Versions.v2)
+ * model AlsoRemovedInV2 {}
+ *
+ * model Foo {
+ *   name: string;
+ *
+ *   @removed(Versions.v3)
+ *   removedInV3: string;
+ * }
+ * ```
+ */
+extern dec removed(
+  target:
+    | Model
+    | ModelProperty
+    | Operation
+    | Enum
+    | EnumMember
+    | Union
+    | UnionVariant
+    | Scalar
+    | Interface,
+  version: EnumMember
+);
 
-    /**
-     * Identifies when a target was made optional.
-     * @param version The version that the target was made optional in.
-     *
-     * @example
-     *
-     * ```tsp
-     * model Foo {
-     *   name: string;
-     *   @madeOptional(Versions.v2)
-     *   nickname: string;
-     * }
-     * ```
-     */
-    extern dec madeOptional(target: ModelProperty, version: EnumMember);
+/**
+ * Identifies when the target has been renamed.
+ * @param version The version that the target was renamed in.
+ * @param oldName The previous name of the target.
+ *
+ * @example
+ * ```tsp
+ * @renamedFrom(Versions.v2, "oldName")
+ * op newName(): void;
+ * ```
+ */
+extern dec renamedFrom(
+  target:
+    | Model
+    | ModelProperty
+    | Operation
+    | Enum
+    | EnumMember
+    | Union
+    | UnionVariant
+    | Scalar
+    | Interface,
+  version: EnumMember,
+  oldName: valueof string
+);
 
-    /**
-     * Identifies when a target was made required.
-     * @param version The version that the target was made required in.
-     *
-     * @example
-     *
-     * ```tsp
-     * model Foo {
-     *   name: string;
-     *   @madeRequired(Versions.v2)
-     *   nickname: string;
-     * }
-     * ```
-     */
-    extern dec madeRequired(target: ModelProperty, version: EnumMember);
+/**
+ * Identifies when a target was made optional.
+ * @param version The version that the target was made optional in.
+ *
+ * @example
+ *
+ * ```tsp
+ * model Foo {
+ *   name: string;
+ *   @madeOptional(Versions.v2)
+ *   nickname: string;
+ * }
+ * ```
+ */
+extern dec madeOptional(target: ModelProperty, version: EnumMember);
 
-    /**
-     * Identifies when the target type changed.
-     * @param version The version that the target type changed in.
-     * @param oldType The previous type of the target.
-     */
-    extern dec typeChangedFrom(target: ModelProperty, version: EnumMember, oldType: unknown);
+/**
+ * Identifies when a target was made required.
+ * @param version The version that the target was made required in.
+ *
+ * @example
+ *
+ * ```tsp
+ * model Foo {
+ *   name: string;
+ *   @madeRequired(Versions.v2)
+ *   nickname: string;
+ * }
+ * ```
+ */
+extern dec madeRequired(target: ModelProperty, version: EnumMember);
 
-    /**
-     * Identifies when the target type changed.
-     * @param version The version that the target type changed in.
-     * @param oldType The previous type of the target.
-     */
-    extern dec returnTypeChangedFrom(target: Operation, version: EnumMember, oldType: unknown);
+/**
+ * Identifies when the target type changed.
+ * @param version The version that the target type changed in.
+ * @param oldType The previous type of the target.
+ */
+extern dec typeChangedFrom(target: ModelProperty, version: EnumMember, oldType: unknown);
 
-    /**
-     * Returns whether the target exists for the given version.
-     * @param version The version to check.
-     */
-    extern fn existsAtVersion(target: unknown, version: EnumMember): boolean;
-
-    /**
-     * Returns whether the target has a different name for the given version.
-     * @param version The version to check.
-     */
-    extern fn hasDifferentNameAtVersion(target: unknown, version: EnumMember): boolean;
-
-    /**
-     * Returns whether the target was made optional after the given version.
-     * @param version The version to check.
-     */
-    extern fn madeOptionalAfter(target: unknown, version: EnumMember): boolean;
-
-    /**
-     * Returns whether the target was made required after the given version.
-     * @param version The version to check.
-     */
-    extern fn madeRequiredAfter(target: unknown, version: EnumMember): boolean;
-
-    /**
-     * Returns whether the version exists for the provided enum member.
-     * @param version The version to check.
-     */
-    extern fn getVersionForEnumMember(target: unknown, version: EnumMember): boolean;
-  }
-}
+/**
+ * Identifies when the target type changed.
+ * @param version The version that the target type changed in.
+ * @param oldType The previous type of the target.
+ */
+extern dec returnTypeChangedFrom(target: Operation, version: EnumMember, oldType: unknown);

package/lib/main.tsp

@@ -0,0 +1,3 @@
+import "./decorators.tsp";
+import "./projection.tsp";
+import "../dist/src/validate.js";

package/lib/{versioning.tsp → projection.tsp}

@@ -1,7 +1,39 @@
-import "./decorators.tsp";
-import "../dist/src/validate.js";
+import "../dist/src/internal-projection-functions.js";
 
 using TypeSpec.Versioning;
+using TypeSpec.Reflection;
+
+namespace TypeSpec.Versioning;
+
+/**
+ * Returns whether the target exists for the given version.
+ * @param version The version to check.
+ */
+extern fn existsAtVersion(target: unknown, version: EnumMember): boolean;
+
+/**
+ * Returns whether the target has a different name for the given version.
+ * @param version The version to check.
+ */
+extern fn hasDifferentNameAtVersion(target: unknown, version: EnumMember): boolean;
+
+/**
+ * Returns whether the target has a different return type for the given version.
+ * @param version The version to check.
+ */
+extern fn hasDifferentReturnTypeAtVersion(target: unknown, version: EnumMember): boolean;
+
+/**
+ * Returns whether the target was made optional after the given version.
+ * @param version The version to check.
+ */
+extern fn madeOptionalAfter(target: unknown, version: EnumMember): boolean;
+
+/**
+ * Returns whether the target was made required after the given version.
+ * @param version The version to check.
+ */
+extern fn madeRequiredAfter(target: unknown, version: EnumMember): boolean;
 
 #suppress "projections-are-experimental"
 projection op#v {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@typespec/versioning",
-  "version": "0.57.0-dev.5",
+  "version": "0.57.0-dev.6",
   "author": "Microsoft Corporation",
   "description": "TypeSpec library for declaring and emitting versioned APIs",
   "homepage": "https://typespec.io",
@@ -18,7 +18,7 @@
   ],
   "type": "module",
   "main": "dist/src/index.js",
-  "tspMain": "lib/versioning.tsp",
+  "tspMain": "lib/main.tsp",
   "exports": {
     ".": {
       "types": "./dist/src/index.d.ts",