@azure-tools/typespec-rust 0.35.0 → 0.37.0

package/dist/src/tcgcadapter/adapter.d.ts

@@ -1,4 +1,5 @@
 import * as tsp from '@typespec/compiler';
+import * as http from '@typespec/http';
 import { RustEmitterOptions } from '../lib.js';
 import * as rust from '../codemodel/index.js';
 /** ErrorCode defines the types of adapter errors */
@@ -42,6 +43,7 @@ export declare class Adapter {
     private readonly crate;
     private readonly ctx;
     private readonly options;
+    private readonly rootNamespace;
     private readonly types;
     private readonly clientMethodParams;
     private readonly fieldsMap;
@@ -50,6 +52,13 @@ export declare class Adapter {
     tcgcToCrate(): rust.Crate;
     /** converts tcgc docs to formatted rust.Docs */
     private adaptDocs;
+    /**
+     * adapts the specified namespace to a hierarchy of Rust modules
+     *
+     * @param namespace the namespace for which to return the package
+     * @returns the leaf module in the namespace
+     */
+    private adaptNamespace;
     /** converts all tcgc types to their Rust type equivalent */
     private adaptTypes;
     /**
@@ -91,6 +100,55 @@ export declare class Adapter {
      */
     private getDiscriminatedUnion;
     private getSerializedPropertyName;
+    /**
+     * converts a non-discriminated tcgc union to either a flat merged Rust Enum (union-of-enums)
+     * or a Rust UntaggedUnion (#[serde(untagged)] enum).
+     * self-registers the result in the owning module and caches it.
+     *
+     * @param src the non-discriminated tcgc union
+     * @returns a Rust Enum or UntaggedUnion
+     */
+    private getNonDiscriminatedUnion;
+    /**
+     * synthesizes a union name for anonymous inline unions by concatenating variant type names
+     *
+     * @param src the non-discriminated tcgc union
+     * @returns a PascalCase name for the union
+     */
+    private synthesizeUnionName;
+    /**
+     * builds a flat merged Rust Enum from a union whose every variant is a TSP enum type.
+     * all variant enum values are merged into a single flat enum.
+     *
+     * @param unionName the PascalCase name for the resulting enum
+     * @param src the non-discriminated tcgc union
+     * @returns a flat merged Rust Enum
+     */
+    private getMergedFlatEnum;
+    /**
+     * builds an UntaggedUnion (#[serde(untagged)] enum) from a non-discriminated tcgc union
+     * whose variants are not all enum types.
+     *
+     * @param unionName the PascalCase name for the resulting union
+     * @param src the non-discriminated tcgc union
+     * @returns a Rust UntaggedUnion
+     */
+    private buildUntaggedUnion;
+    /**
+     * returns the sort order for a variant in a #[serde(untagged)] enum.
+     * more specific types must come before more general ones to ensure correct deserialization.
+     *
+     * @param variant the tcgc type to get the order for
+     * @returns a numeric sort key (lower = earlier)
+     */
+    private getUntaggedVariantOrder;
+    /**
+     * returns the Rust variant name (PascalCase) for a variant in a #[serde(untagged)] enum.
+     *
+     * @param variant the tcgc type to name
+     * @returns a PascalCase Rust variant name
+     */
+    private getUntaggedVariantName;
     /**
      * converts a tcgc model property to a model field
      *
@@ -233,9 +291,15 @@ export declare class Adapter {
      */
     private adaptPageableMethodReinjectionParams;
     /**
-     * converts a tcgc operation parameter into a Rust method parameter
+     * converts a tcgc operation parameter into a Rust method parameter.
+     * note that when methodParam is present, we must use all applicable
+     * values from methodParam as the source of truth. e.g. when overriding
+     * a method to make an optional param required, the requiredness will
+     * be reflected in the method param, _not_ the operation param.
      *
-     * @param param the tcgc operation parameter to convert
+     * @param opParam the tcgc operation parameter to convert
+     * @param methodParam the tcgc method parameter associated with opParam
+     * @param lifetime optional lifetime to stamp on borrowed ref types (used for grouped params that are struct fields)
      * @returns a Rust method parameter
      */
     private adaptMethodParameter;
@@ -247,6 +311,7 @@ export declare class Adapter {
      *
      * @param type the param type to be updated
      * @param kind the kind of param
+     * @param lifetime optional lifetime to stamp on Ref types (used for struct fields)
      * @returns the updated param type or undefined
      */
     private canBorrowMethodParam;
@@ -268,18 +333,21 @@ export declare class Adapter {
      */
     private adaptMethodSpreadParameter;
     /**
-     * converts a Content-Type header value into a payload format
-     *
-     * @param contentType the value of the Content-Type header
-     * @returns a payload format
-     */
-    private adaptPayloadFormat;
-    /**
-     * converts an accept or content-type header value into a payload format type
+     * determines the payload format type from serializationOptions on the type, falling
+     * back to inspecting the defaultContentType when serializationOptions isn't available.
      *
-     * @param contentType the value of the Accept or Content-Type header
-     * @returns a response format
+     * @param type the SDK type associated with the payload, if available
+     * @param defaultContentType the value of the Accept or Content-Type header
+     * @returns a payload format type
      */
-    private adaptPayloadFormatType;
+    private getPayloadFormatType;
 }
+/**
+ * converts an array of Visibility flags to a sorted, human-readable string.
+ * returns undefined if visibility is unrestricted (all flags or undefined).
+ *
+ * @param visibility the visibility flags from TCGC
+ * @returns a formatted string like "Read" or "Create, Update", or undefined if unrestricted
+ */
+export declare function formatVisibility(visibility?: http.Visibility[]): string | undefined;
 //# sourceMappingURL=adapter.d.ts.map

package/dist/src/tcgcadapter/adapter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"adapter.d.ts","sourceRoot":"","sources":["../../../src/tcgcadapter/adapter.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"adapter.d.ts","sourceRoot":"","sources":["../../../src/tcgcadapter/adapter.ts"],"names":[],"mappings":"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"}