@azure-tools/typespec-azure-resource-manager 0.69.0 → 0.70.0-dev.1

package/lib/base-types/base-types.tsp

@@ -0,0 +1,39 @@
+using Reflection;
+
+namespace Azure.ResourceManager.BaseTypes;
+
+/**
+ * An ARM-managed base type descriptor identifying the schema contract a resource conforms to.
+ * Used as a parameter to the `@azureBaseType` decorator to indicate which
+ * base types a resource conforms to.
+ */
+model BaseTypeInfo {
+  /** The base type identifier (for example, "Agent"). */
+  baseType: string;
+
+  /** The schema version of the base type. */
+  version: string;
+}
+
+/**
+ * `@azureBaseType` marks an Azure Resource Manager resource properties model as implementing
+ * a base type. Base types define structured constraints including required and
+ * optional properties that conforming resources must implement.
+ *
+ * This decorator may be applied multiple times to indicate conformance to
+ * multiple base types. Duplicate entries are ignored.
+ *
+ * @param baseType The base type specification this resource implements.
+ *
+ * @example
+ *
+ * ```typespec
+ * @azureBaseType(#{ baseType: "Agent", version: "2024-06-01" })
+ * model MyAgentProperties {
+ *   ...AgentProperties;
+ *   ...AgentToolProperty;
+ *   ...DefaultProvisioningStateProperty;
+ * }
+ * ```
+ */
+extern dec azureBaseType(target: Model, baseType: valueof BaseTypeInfo);

package/lib/private.decorators.tsp

@@ -119,6 +119,22 @@ extern dec armResourcePropertiesOptionality(target: ModelProperty, isOptional: v
 /** designates a parameter as an explicit bodyRoot and sets the optionality of the parameter */
 extern dec armBodyRoot(target: ModelProperty, isOptional: valueof boolean);
 
+/**
+ * Controls visibility of a base type property based on whether the property is present
+ * and whether the deployment model is Appliance or Platform.
+ *
+ * If `isPresent` is false, the property is made invisible (removed from all lifecycle visibility).
+ * If `isAppliance` is true, the property is made read-only.
+ *
+ * @param isPresent Whether this property is present in the current template instantiation.
+ * @param isAppliance Whether the current deployment model is Appliance (true) or Platform (false).
+ */
+extern dec baseTypeOptional(
+  target: ModelProperty,
+  isPresent: valueof boolean,
+  isAppliance: valueof boolean
+);
+
 /** designates a type as a legacy type and emits a warning diagnostic when used */
 extern dec legacyType(target: Model | Operation | Interface | Scalar);
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@azure-tools/typespec-azure-resource-manager",
-  "version": "0.69.0",
+  "version": "0.70.0-dev.1",
   "author": "Microsoft Corporation",
   "description": "TypeSpec Azure Resource Manager library",
   "homepage": "https://azure.github.io/typespec-azure",
@@ -47,29 +47,29 @@
     "pluralize": "^8.0.0"
   },
   "peerDependencies": {
-    "@azure-tools/typespec-azure-core": "^0.69.0",
+    "@azure-tools/typespec-azure-core": "^0.69.0 || >=0.70.0-dev <0.70.0",
     "@typespec/compiler": "^1.13.0",
     "@typespec/http": "^1.13.0",
-    "@typespec/rest": "^0.83.0",
+    "@typespec/rest": "^0.83.0 || >=0.84.0-dev <0.84.0",
     "@typespec/openapi": "^1.13.0",
-    "@typespec/versioning": "^0.83.0"
+    "@typespec/versioning": "^0.83.0 || >=0.84.0-dev <0.84.0"
   },
   "devDependencies": {
+    "@azure-tools/typespec-azure-core": "^0.69.0 || >=0.70.0-dev <0.70.0",
     "@types/node": "^25.5.2",
     "@types/pluralize": "^0.0.33",
+    "@typespec/compiler": "^1.13.0",
+    "@typespec/http": "^1.13.0",
+    "@typespec/library-linter": "^0.83.0 || >=0.84.0-dev <0.84.0",
+    "@typespec/rest": "^0.83.0 || >=0.84.0-dev <0.84.0",
+    "@typespec/tspd": "^0.75.0 || >=0.76.0-dev <0.76.0",
+    "@typespec/versioning": "^0.83.0 || >=0.84.0-dev <0.84.0",
+    "@typespec/openapi": "^1.13.0",
     "@vitest/coverage-v8": "^4.1.3",
     "@vitest/ui": "^4.1.3",
     "rimraf": "^6.1.3",
     "typescript": "~6.0.2",
-    "vitest": "^4.1.3",
-    "@typespec/compiler": "^1.13.0",
-    "@azure-tools/typespec-azure-core": "^0.69.0",
-    "@typespec/http": "^1.13.0",
-    "@typespec/tspd": "^0.75.0",
-    "@typespec/library-linter": "^0.83.0",
-    "@typespec/rest": "^0.83.0",
-    "@typespec/versioning": "^0.83.0",
-    "@typespec/openapi": "^1.13.0"
+    "vitest": "^4.1.3"
   },
   "scripts": {
     "clean": "rimraf ./dist ./temp",