@azure-tools/typespec-azure-resource-manager 0.70.0-dev.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.70.0-dev.0",
+  "version": "0.70.0-dev.1",
   "author": "Microsoft Corporation",
   "description": "TypeSpec Azure Resource Manager library",
   "homepage": "https://azure.github.io/typespec-azure",