react-native-executorch 0.5.6 → 0.5.8

package/third-party/include/executorch/ExecuTorchTensor.h

@@ -82,8 +82,7 @@ ExecuTorchSizeOfDataType(ExecuTorchDataType dataType)
  */
 FOUNDATION_EXPORT
 __attribute__((deprecated("This API is experimental."))) NSInteger
-ExecuTorchElementCountOfShape(NSArray<NSNumber *> *shape)
-    NS_SWIFT_NAME(elementCount(ofShape:));
+ExecuTorchElementCountOfShape(NSArray<NSNumber *> *shape) NS_REFINED_FOR_SWIFT;
 
 /**
  * A tensor class for ExecuTorch operations.
@@ -91,7 +90,7 @@ ExecuTorchElementCountOfShape(NSArray<NSNumber *> *shape)
  * This class encapsulates a native TensorPtr instance and provides a variety of
  * initializers and utility methods to work with tensor data.
  */
-NS_SWIFT_NAME(Tensor)
+NS_SWIFT_NAME(AnyTensor)
 __attribute__((deprecated("This API is experimental.")))
 @interface ExecuTorchTensor : NSObject<NSCopying>
 
@@ -115,7 +114,7 @@ __attribute__((deprecated("This API is experimental.")))
  * @return An NSArray of NSNumber objects representing the size of each
  * dimension.
  */
-@property(nonatomic, readonly) NSArray<NSNumber *> *shape;
+@property(nonatomic, readonly) NSArray<NSNumber *> *shape NS_REFINED_FOR_SWIFT;
 
 /**
  * The order of dimensions in the tensor.
@@ -123,7 +122,8 @@ __attribute__((deprecated("This API is experimental.")))
  * @return An NSArray of NSNumber objects representing the tensor’s dimension
  * order.
  */
-@property(nonatomic, readonly) NSArray<NSNumber *> *dimensionOrder;
+@property(nonatomic, readonly)
+    NSArray<NSNumber *> *dimensionOrder NS_REFINED_FOR_SWIFT;
 
 /**
  * The strides of the tensor.
@@ -131,7 +131,8 @@ __attribute__((deprecated("This API is experimental.")))
  * @return An NSArray of NSNumber objects representing the step sizes for each
  * dimension.
  */
-@property(nonatomic, readonly) NSArray<NSNumber *> *strides;
+@property(nonatomic, readonly)
+    NSArray<NSNumber *> *strides NS_REFINED_FOR_SWIFT;
 
 /**
  * The dynamism of the tensor's shape.
@@ -146,7 +147,7 @@ __attribute__((deprecated("This API is experimental.")))
  *
  * @return An NSInteger representing the total element count.
  */
-@property(nonatomic, readonly) NSInteger count;
+@property(nonatomic, readonly) NSInteger count NS_REFINED_FOR_SWIFT;
 
 /**
  * Initializes a tensor with a native TensorPtr instance.
@@ -158,16 +159,18 @@ __attribute__((deprecated("This API is experimental.")))
     NS_DESIGNATED_INITIALIZER NS_SWIFT_UNAVAILABLE("");
 
 /**
- * Creates a new tensor by copying an existing tensor.
+ * Creates a new tensor that shares the underlying data storage with the
+ * given tensor. This new tensor is a view and does not own the data.
  *
- * @param otherTensor The tensor instance to copy.
- * @return A new ExecuTorchTensor instance that is a copy of otherTensor.
+ * @param otherTensor The tensor instance to create a view of.
+ * @return A new ExecuTorchTensor instance that shares data with otherTensor.
  */
 - (instancetype)initWithTensor:(ExecuTorchTensor *)otherTensor
     NS_SWIFT_NAME(init(_:));
 
 /**
- * Returns a copy of the tensor.
+ * Creates a deep copy of the tensor.
+ * The new tensor will have its own copy of the data.
  *
  * @return A new ExecuTorchTensor instance that is a duplicate of the current
  * tensor.
@@ -182,8 +185,9 @@ __attribute__((deprecated("This API is experimental.")))
  *   - the total number of elements,
  *   - and the data type.
  */
-- (void)bytesWithHandler:(void (^)(const void *pointer, NSInteger count,
-                                   ExecuTorchDataType dataType))handler
+- (void)bytesWithHandler:
+    (NS_NOESCAPE void (^)(const void *pointer, NSInteger count,
+                          ExecuTorchDataType dataType))handler
     NS_SWIFT_NAME(bytes(_:));
 
 /**
@@ -194,8 +198,9 @@ __attribute__((deprecated("This API is experimental.")))
  *   - the total number of elements,
  *   - and the data type.
  */
-- (void)mutableBytesWithHandler:(void (^)(void *pointer, NSInteger count,
-                                          ExecuTorchDataType dataType))handler
+- (void)mutableBytesWithHandler:
+    (NS_NOESCAPE void (^)(void *pointer, NSInteger count,
+                          ExecuTorchDataType dataType))handler
     NS_SWIFT_NAME(mutableBytes(_:));
 
 /**
@@ -207,16 +212,16 @@ __attribute__((deprecated("This API is experimental.")))
  * @return YES if the tensor was successfully resized; otherwise, NO.
  */
 - (BOOL)resizeToShape:(NSArray<NSNumber *> *)shape
-                error:(NSError **)error NS_SWIFT_NAME(resize(to:));
+                error:(NSError **)error NS_REFINED_FOR_SWIFT;
 
 /**
  * Determines whether the current tensor is equal to another tensor.
  *
  * @param other Another ExecuTorchTensor instance to compare against.
- * @return YES if the tensors have the same type, shape, strides, and data;
- * otherwise, NO.
+ * @return YES if the tensors have the same data type, shape, dimension order,
+ * strides, and underlying data; otherwise, NO.
  */
-- (BOOL)isEqualToTensor:(nullable ExecuTorchTensor *)other;
+- (BOOL)isEqualToTensor:(nullable ExecuTorchTensor *)other NS_REFINED_FOR_SWIFT;
 
 + (instancetype)new NS_UNAVAILABLE;
 - (instancetype)init NS_UNAVAILABLE;
@@ -247,7 +252,8 @@ __attribute__((deprecated("This API is experimental.")))
                             strides:(NSArray<NSNumber *> *)strides
                      dimensionOrder:(NSArray<NSNumber *> *)dimensionOrder
                            dataType:(ExecuTorchDataType)dataType
-                      shapeDynamism:(ExecuTorchShapeDynamism)shapeDynamism;
+                      shapeDynamism:(ExecuTorchShapeDynamism)shapeDynamism
+    NS_REFINED_FOR_SWIFT;
 
 /**
  * Initializes a tensor without copying data using dynamic bound shape (default
@@ -266,7 +272,8 @@ __attribute__((deprecated("This API is experimental.")))
                               shape:(NSArray<NSNumber *> *)shape
                             strides:(NSArray<NSNumber *> *)strides
                      dimensionOrder:(NSArray<NSNumber *> *)dimensionOrder
-                           dataType:(ExecuTorchDataType)dataType;
+                           dataType:(ExecuTorchDataType)dataType
+    NS_SWIFT_UNAVAILABLE("");
 
 /**
  * Initializes a tensor without copying data, with an explicit shape dynamism.
@@ -281,7 +288,8 @@ __attribute__((deprecated("This API is experimental.")))
 - (instancetype)initWithBytesNoCopy:(void *)pointer
                               shape:(NSArray<NSNumber *> *)shape
                            dataType:(ExecuTorchDataType)dataType
-                      shapeDynamism:(ExecuTorchShapeDynamism)shapeDynamism;
+                      shapeDynamism:(ExecuTorchShapeDynamism)shapeDynamism
+    NS_SWIFT_UNAVAILABLE("");
 
 /**
  * Initializes a tensor without copying data, specifying only the shape and data
@@ -294,7 +302,8 @@ __attribute__((deprecated("This API is experimental.")))
  */
 - (instancetype)initWithBytesNoCopy:(void *)pointer
                               shape:(NSArray<NSNumber *> *)shape
-                           dataType:(ExecuTorchDataType)dataType;
+                           dataType:(ExecuTorchDataType)dataType
+    NS_SWIFT_UNAVAILABLE("");
 
 @end
 
@@ -322,7 +331,8 @@ __attribute__((deprecated("This API is experimental.")))
                       strides:(NSArray<NSNumber *> *)strides
                dimensionOrder:(NSArray<NSNumber *> *)dimensionOrder
                      dataType:(ExecuTorchDataType)dataType
-                shapeDynamism:(ExecuTorchShapeDynamism)shapeDynamism;
+                shapeDynamism:(ExecuTorchShapeDynamism)shapeDynamism
+    NS_REFINED_FOR_SWIFT;
 
 /**
  * Initializes a tensor by copying bytes from the provided pointer with dynamic
@@ -342,7 +352,8 @@ __attribute__((deprecated("This API is experimental.")))
                         shape:(NSArray<NSNumber *> *)shape
                       strides:(NSArray<NSNumber *> *)strides
                dimensionOrder:(NSArray<NSNumber *> *)dimensionOrder
-                     dataType:(ExecuTorchDataType)dataType;
+                     dataType:(ExecuTorchDataType)dataType
+    NS_SWIFT_UNAVAILABLE("");
 
 /**
  * Initializes a tensor by copying bytes from the provided pointer, specifying
@@ -359,7 +370,8 @@ __attribute__((deprecated("This API is experimental.")))
 - (instancetype)initWithBytes:(const void *)pointer
                         shape:(NSArray<NSNumber *> *)shape
                      dataType:(ExecuTorchDataType)dataType
-                shapeDynamism:(ExecuTorchShapeDynamism)shapeDynamism;
+                shapeDynamism:(ExecuTorchShapeDynamism)shapeDynamism
+    NS_SWIFT_UNAVAILABLE("");
 
 /**
  * Initializes a tensor by copying bytes from the provided pointer, specifying
@@ -373,7 +385,8 @@ __attribute__((deprecated("This API is experimental.")))
  */
 - (instancetype)initWithBytes:(const void *)pointer
                         shape:(NSArray<NSNumber *> *)shape
-                     dataType:(ExecuTorchDataType)dataType;
+                     dataType:(ExecuTorchDataType)dataType
+    NS_SWIFT_UNAVAILABLE("");
 
 @end
 
@@ -382,7 +395,9 @@ __attribute__((deprecated("This API is experimental.")))
 @interface ExecuTorchTensor (Data)
 
 /**
- * Initializes a tensor using an NSData object as the underlying data buffer.
+ * Initializes a tensor using an NSData object. The tensor will hold a
+ * strong reference to the NSData object to manage the lifetime of the
+ * underlying data buffer, which is not copied.
  *
  * @param data An NSData object containing the tensor data.
  * @param shape An NSArray of NSNumber objects representing the tensor's shape.
@@ -400,7 +415,8 @@ __attribute__((deprecated("This API is experimental.")))
                      strides:(NSArray<NSNumber *> *)strides
               dimensionOrder:(NSArray<NSNumber *> *)dimensionOrder
                     dataType:(ExecuTorchDataType)dataType
-               shapeDynamism:(ExecuTorchShapeDynamism)shapeDynamism;
+               shapeDynamism:(ExecuTorchShapeDynamism)shapeDynamism
+    NS_REFINED_FOR_SWIFT;
 
 /**
  * Initializes a tensor using an NSData object as the underlying data buffer
@@ -419,7 +435,8 @@ __attribute__((deprecated("This API is experimental.")))
                        shape:(NSArray<NSNumber *> *)shape
                      strides:(NSArray<NSNumber *> *)strides
               dimensionOrder:(NSArray<NSNumber *> *)dimensionOrder
-                    dataType:(ExecuTorchDataType)dataType;
+                    dataType:(ExecuTorchDataType)dataType
+    NS_SWIFT_UNAVAILABLE("");
 
 /**
  * Initializes a tensor using an NSData object as the underlying data buffer,
@@ -435,7 +452,8 @@ __attribute__((deprecated("This API is experimental.")))
 - (instancetype)initWithData:(NSData *)data
                        shape:(NSArray<NSNumber *> *)shape
                     dataType:(ExecuTorchDataType)dataType
-               shapeDynamism:(ExecuTorchShapeDynamism)shapeDynamism;
+               shapeDynamism:(ExecuTorchShapeDynamism)shapeDynamism
+    NS_SWIFT_UNAVAILABLE("");
 
 /**
  * Initializes a tensor using an NSData object as the underlying data buffer,
@@ -448,7 +466,8 @@ __attribute__((deprecated("This API is experimental.")))
  */
 - (instancetype)initWithData:(NSData *)data
                        shape:(NSArray<NSNumber *> *)shape
-                    dataType:(ExecuTorchDataType)dataType;
+                    dataType:(ExecuTorchDataType)dataType
+    NS_SWIFT_UNAVAILABLE("");
 
 @end
 
@@ -479,7 +498,7 @@ __attribute__((deprecated("This API is experimental.")))
                  dimensionOrder:(NSArray<NSNumber *> *)dimensionOrder
                        dataType:(ExecuTorchDataType)dataType
                   shapeDynamism:(ExecuTorchShapeDynamism)shapeDynamism
-    NS_SWIFT_NAME(init(_:shape:strides:dimensionOrder:dataType:shapeDynamism:));
+    NS_SWIFT_UNAVAILABLE("");
 
 /**
  * Initializes a tensor with an array of scalar values, specifying shape,
@@ -502,7 +521,7 @@ __attribute__((deprecated("This API is experimental.")))
                         strides:(NSArray<NSNumber *> *)strides
                  dimensionOrder:(NSArray<NSNumber *> *)dimensionOrder
                        dataType:(ExecuTorchDataType)dataType
-    NS_SWIFT_NAME(init(_:shape:strides:dimensionOrder:dataType:));
+    NS_SWIFT_UNAVAILABLE("");
 
 /**
  * Initializes a tensor with an array of scalar values, specifying the desired
@@ -520,7 +539,7 @@ __attribute__((deprecated("This API is experimental.")))
                           shape:(NSArray<NSNumber *> *)shape
                        dataType:(ExecuTorchDataType)dataType
                   shapeDynamism:(ExecuTorchShapeDynamism)shapeDynamism
-    NS_SWIFT_NAME(init(_:shape:dataType:shapeDynamism:));
+    NS_SWIFT_UNAVAILABLE("");
 
 /**
  * Initializes a tensor with an array of scalar values and a specified shape,
@@ -535,7 +554,7 @@ __attribute__((deprecated("This API is experimental.")))
 - (instancetype)initWithScalars:(NSArray<NSNumber *> *)scalars
                           shape:(NSArray<NSNumber *> *)shape
                        dataType:(ExecuTorchDataType)dataType
-    NS_SWIFT_NAME(init(_:shape:dataType:));
+    NS_SWIFT_UNAVAILABLE("");
 
 /**
  * Initializes a tensor with an array of scalar values, specifying the tensor
@@ -552,7 +571,7 @@ __attribute__((deprecated("This API is experimental.")))
 - (instancetype)initWithScalars:(NSArray<NSNumber *> *)scalars
                        dataType:(ExecuTorchDataType)dataType
                   shapeDynamism:(ExecuTorchShapeDynamism)shapeDynamism
-    NS_SWIFT_NAME(init(_:dataType:shapeDynamism:));
+    NS_SWIFT_UNAVAILABLE("");
 
 /**
  * Initializes a tensor with an array of scalar values, specifying the tensor
@@ -565,7 +584,7 @@ __attribute__((deprecated("This API is experimental.")))
  */
 - (instancetype)initWithScalars:(NSArray<NSNumber *> *)scalars
                        dataType:(ExecuTorchDataType)dataType
-    NS_SWIFT_NAME(init(_:dataType:));
+    NS_SWIFT_UNAVAILABLE("");
 
 /**
  * Initializes a tensor with an array of scalar values, a specified shape and
@@ -582,7 +601,7 @@ __attribute__((deprecated("This API is experimental.")))
 - (instancetype)initWithScalars:(NSArray<NSNumber *> *)scalars
                           shape:(NSArray<NSNumber *> *)shape
                   shapeDynamism:(ExecuTorchShapeDynamism)shapeDynamism
-    NS_SWIFT_NAME(init(_:shape:shapeDynamism:));
+    NS_SWIFT_UNAVAILABLE("");
 
 /**
  * Initializes a tensor with an array of scalar values and a specified shape.
@@ -595,7 +614,7 @@ __attribute__((deprecated("This API is experimental.")))
  */
 - (instancetype)initWithScalars:(NSArray<NSNumber *> *)scalars
                           shape:(NSArray<NSNumber *> *)shape
-    NS_SWIFT_NAME(init(_:shape:));
+    NS_SWIFT_UNAVAILABLE("");
 
 /**
  * Initializes a tensor with an array of scalar values, automatically deducing
@@ -606,7 +625,7 @@ __attribute__((deprecated("This API is experimental.")))
  * deduced.
  */
 - (instancetype)initWithScalars:(NSArray<NSNumber *> *)scalars
-    NS_SWIFT_NAME(init(_:));
+    NS_SWIFT_UNAVAILABLE("");
 
 @end
 
@@ -621,7 +640,7 @@ __attribute__((deprecated("This API is experimental.")))
  */
 - (instancetype)initWithScalar:(NSNumber *)scalar
                       dataType:(ExecuTorchDataType)dataType
-    NS_SWIFT_NAME(init(_:dataType:));
+    NS_REFINED_FOR_SWIFT;
 
 /**
  * Initializes a tensor with a single scalar value, automatically deducing its
@@ -630,7 +649,7 @@ __attribute__((deprecated("This API is experimental.")))
  * @param scalar An NSNumber representing the scalar value.
  * @return An initialized ExecuTorchTensor instance representing the scalar.
  */
-- (instancetype)initWithScalar:(NSNumber *)scalar NS_SWIFT_NAME(init(_:));
+- (instancetype)initWithScalar:(NSNumber *)scalar NS_SWIFT_UNAVAILABLE("");
 
 /**
  * Initializes a tensor with a byte scalar value.
@@ -638,7 +657,7 @@ __attribute__((deprecated("This API is experimental.")))
  * @param scalar A uint8_t value.
  * @return An initialized ExecuTorchTensor instance.
  */
-- (instancetype)initWithByte:(uint8_t)scalar NS_SWIFT_NAME(init(_:));
+- (instancetype)initWithByte:(uint8_t)scalar NS_SWIFT_UNAVAILABLE("");
 
 /**
  * Initializes a tensor with a char scalar value.
@@ -646,7 +665,7 @@ __attribute__((deprecated("This API is experimental.")))
  * @param scalar An int8_t value.
  * @return An initialized ExecuTorchTensor instance.
  */
-- (instancetype)initWithChar:(int8_t)scalar NS_SWIFT_NAME(init(_:));
+- (instancetype)initWithChar:(int8_t)scalar NS_SWIFT_UNAVAILABLE("");
 
 /**
  * Initializes a tensor with a short scalar value.
@@ -654,7 +673,7 @@ __attribute__((deprecated("This API is experimental.")))
  * @param scalar An int16_t value.
  * @return An initialized ExecuTorchTensor instance.
  */
-- (instancetype)initWithShort:(int16_t)scalar NS_SWIFT_NAME(init(_:));
+- (instancetype)initWithShort:(int16_t)scalar NS_SWIFT_UNAVAILABLE("");
 
 /**
  * Initializes a tensor with an int scalar value.
@@ -662,7 +681,7 @@ __attribute__((deprecated("This API is experimental.")))
  * @param scalar An int32_t value.
  * @return An initialized ExecuTorchTensor instance.
  */
-- (instancetype)initWithInt:(int32_t)scalar NS_SWIFT_NAME(init(_:));
+- (instancetype)initWithInt:(int32_t)scalar NS_SWIFT_UNAVAILABLE("");
 
 /**
  * Initializes a tensor with a long scalar value.
@@ -670,7 +689,7 @@ __attribute__((deprecated("This API is experimental.")))
  * @param scalar An int64_t value.
  * @return An initialized ExecuTorchTensor instance.
  */
-- (instancetype)initWithLong:(int64_t)scalar NS_SWIFT_NAME(init(_:));
+- (instancetype)initWithLong:(int64_t)scalar NS_SWIFT_UNAVAILABLE("");
 
 /**
  * Initializes a tensor with a float scalar value.
@@ -678,7 +697,7 @@ __attribute__((deprecated("This API is experimental.")))
  * @param scalar A float value.
  * @return An initialized ExecuTorchTensor instance.
  */
-- (instancetype)initWithFloat:(float)scalar NS_SWIFT_NAME(init(_:));
+- (instancetype)initWithFloat:(float)scalar NS_SWIFT_UNAVAILABLE("");
 
 /**
  * Initializes a tensor with a double scalar value.
@@ -686,7 +705,7 @@ __attribute__((deprecated("This API is experimental.")))
  * @param scalar A double value.
  * @return An initialized ExecuTorchTensor instance.
  */
-- (instancetype)initWithDouble:(double)scalar NS_SWIFT_NAME(init(_:));
+- (instancetype)initWithDouble:(double)scalar NS_SWIFT_UNAVAILABLE("");
 
 /**
  * Initializes a tensor with a boolean scalar value.
@@ -694,7 +713,7 @@ __attribute__((deprecated("This API is experimental.")))
  * @param scalar A BOOL value.
  * @return An initialized ExecuTorchTensor instance.
  */
-- (instancetype)initWithBool:(BOOL)scalar NS_SWIFT_NAME(init(_:));
+- (instancetype)initWithBool:(BOOL)scalar NS_SWIFT_UNAVAILABLE("");
 
 /**
  * Initializes a tensor with a uint16 scalar value.
@@ -739,4 +758,665 @@ __attribute__((deprecated("This API is experimental.")))
 
 @end
 
+#pragma mark - Empty Category
+
+@interface ExecuTorchTensor (Empty)
+
+/**
+ * Creates an empty tensor with the specified shape, strides, data type, and
+ * shape dynamism.
+ *
+ * @param shape An NSArray of NSNumber objects representing the desired shape.
+ * @param strides An NSArray of NSNumber objects representing the desired
+ * strides.
+ * @param dataType An ExecuTorchDataType value specifying the element type.
+ * @param shapeDynamism An ExecuTorchShapeDynamism value specifying whether the
+ * shape is static or dynamic.
+ * @return A new, empty ExecuTorchTensor instance.
+ */
++ (instancetype)emptyTensorWithShape:(NSArray<NSNumber *> *)shape
+                             strides:(NSArray<NSNumber *> *)strides
+                            dataType:(ExecuTorchDataType)dataType
+                       shapeDynamism:(ExecuTorchShapeDynamism)shapeDynamism
+    NS_REFINED_FOR_SWIFT NS_RETURNS_RETAINED;
+
+/**
+ * Creates an empty tensor with the specified shape, data type, and shape
+ * dynamism.
+ *
+ * @param shape An NSArray of NSNumber objects representing the desired shape.
+ * @param dataType An ExecuTorchDataType value specifying the element type.
+ * @param shapeDynamism An ExecuTorchShapeDynamism value specifying whether the
+ * shape is static or dynamic.
+ * @return A new, empty ExecuTorchTensor instance.
+ */
++ (instancetype)emptyTensorWithShape:(NSArray<NSNumber *> *)shape
+                            dataType:(ExecuTorchDataType)dataType
+                       shapeDynamism:(ExecuTorchShapeDynamism)shapeDynamism
+    NS_SWIFT_UNAVAILABLE("")NS_RETURNS_RETAINED;
+
+/**
+ * Creates an empty tensor with the specified shape and data type, using dynamic
+ * bound shape.
+ *
+ * @param shape An NSArray of NSNumber objects representing the desired shape.
+ * @param dataType An ExecuTorchDataType value specifying the element type.
+ * @return A new, empty ExecuTorchTensor instance.
+ */
++ (instancetype)emptyTensorWithShape:(NSArray<NSNumber *> *)shape
+                            dataType:(ExecuTorchDataType)dataType
+    NS_SWIFT_UNAVAILABLE("")NS_RETURNS_RETAINED;
+
+/**
+ * Creates an empty tensor similar to the given tensor, with the specified data
+ * type and shape dynamism.
+ *
+ * @param tensor An existing ExecuTorchTensor instance whose shape and strides
+ * are used.
+ * @param dataType An ExecuTorchDataType value specifying the desired element
+ * type.
+ * @param shapeDynamism An ExecuTorchShapeDynamism value specifying whether the
+ * shape is static or dynamic.
+ * @return A new, empty ExecuTorchTensor instance with the same shape as the
+ * provided tensor.
+ */
++ (instancetype)emptyTensorLikeTensor:(ExecuTorchTensor *)tensor
+                             dataType:(ExecuTorchDataType)dataType
+                        shapeDynamism:(ExecuTorchShapeDynamism)shapeDynamism
+    NS_REFINED_FOR_SWIFT NS_RETURNS_RETAINED;
+
+/**
+ * Creates an empty tensor similar to the given tensor, with the specified data
+ * type.
+ *
+ * @param tensor An existing ExecuTorchTensor instance whose shape and strides
+ * are used.
+ * @param dataType An ExecuTorchDataType value specifying the desired element
+ * type.
+ * @return A new, empty ExecuTorchTensor instance with the same shape as the
+ * provided tensor.
+ */
++ (instancetype)emptyTensorLikeTensor:(ExecuTorchTensor *)tensor
+                             dataType:(ExecuTorchDataType)dataType
+    NS_SWIFT_UNAVAILABLE("")NS_RETURNS_RETAINED;
+
+/**
+ * Creates an empty tensor similar to the given tensor.
+ *
+ * @param tensor An existing ExecuTorchTensor instance.
+ * @return A new, empty ExecuTorchTensor instance with the same properties as
+ * the provided tensor.
+ */
++ (instancetype)emptyTensorLikeTensor:(ExecuTorchTensor *)tensor
+    NS_SWIFT_UNAVAILABLE("")NS_RETURNS_RETAINED;
+
+@end
+
+#pragma mark - Full Category
+
+@interface ExecuTorchTensor (Full)
+
+/**
+ * Creates a tensor filled with the specified scalar value, with full
+ * specification of shape, strides, data type, and shape dynamism.
+ *
+ * @param shape An NSArray of NSNumber objects representing the desired shape.
+ * @param scalar An NSNumber representing the value to fill the tensor.
+ * @param strides An NSArray of NSNumber objects representing the desired
+ * strides.
+ * @param dataType An ExecuTorchDataType value specifying the element type.
+ * @param shapeDynamism An ExecuTorchShapeDynamism value specifying whether the
+ * shape is static or dynamic.
+ * @return A new ExecuTorchTensor instance filled with the scalar value.
+ */
++ (instancetype)fullTensorWithShape:(NSArray<NSNumber *> *)shape
+                             scalar:(NSNumber *)scalar
+                            strides:(NSArray<NSNumber *> *)strides
+                           dataType:(ExecuTorchDataType)dataType
+                      shapeDynamism:(ExecuTorchShapeDynamism)shapeDynamism
+    NS_REFINED_FOR_SWIFT NS_RETURNS_RETAINED;
+
+/**
+ * Creates a tensor filled with the specified scalar value, with the given
+ * shape, data type, and shape dynamism.
+ *
+ * @param shape An NSArray of NSNumber objects representing the desired shape.
+ * @param scalar An NSNumber representing the value to fill the tensor.
+ * @param dataType An ExecuTorchDataType value specifying the element type.
+ * @param shapeDynamism An ExecuTorchShapeDynamism value specifying whether the
+ * shape is static or dynamic.
+ * @return A new ExecuTorchTensor instance filled with the scalar value.
+ */
++ (instancetype)fullTensorWithShape:(NSArray<NSNumber *> *)shape
+                             scalar:(NSNumber *)scalar
+                           dataType:(ExecuTorchDataType)dataType
+                      shapeDynamism:(ExecuTorchShapeDynamism)shapeDynamism
+    NS_SWIFT_UNAVAILABLE("")NS_RETURNS_RETAINED;
+
+/**
+ * Creates a tensor filled with the specified scalar value, with the given shape
+ * and data type, using dynamic bound shape for strides and dimension order.
+ *
+ * @param shape An NSArray of NSNumber objects representing the desired shape.
+ * @param scalar An NSNumber representing the value to fill the tensor.
+ * @param dataType An ExecuTorchDataType value specifying the element type.
+ * @return A new ExecuTorchTensor instance filled with the scalar value.
+ */
++ (instancetype)fullTensorWithShape:(NSArray<NSNumber *> *)shape
+                             scalar:(NSNumber *)scalar
+                           dataType:(ExecuTorchDataType)dataType
+    NS_SWIFT_UNAVAILABLE("")NS_RETURNS_RETAINED;
+
+/**
+ * Creates a tensor filled with the specified scalar value, similar to an
+ * existing tensor, with the given data type and shape dynamism.
+ *
+ * @param tensr An existing ExecuTorchTensor instance whose shape and strides
+ * are used.
+ * @param scalar An NSNumber representing the value to fill the tensor.
+ * @param dataType An ExecuTorchDataType value specifying the desired element
+ * type.
+ * @param shapeDynamism An ExecuTorchShapeDynamism value specifying whether the
+ * shape is static or dynamic.
+ * @return A new ExecuTorchTensor instance filled with the scalar value.
+ */
++ (instancetype)fullTensorLikeTensor:(ExecuTorchTensor *)tensr
+                              scalar:(NSNumber *)scalar
+                            dataType:(ExecuTorchDataType)dataType
+                       shapeDynamism:(ExecuTorchShapeDynamism)shapeDynamism
+    NS_REFINED_FOR_SWIFT NS_RETURNS_RETAINED;
+
+/**
+ * Creates a tensor filled with the specified scalar value, similar to an
+ * existing tensor, with the given data type.
+ *
+ * @param tensr An existing ExecuTorchTensor instance whose shape and strides
+ * are used.
+ * @param scalar An NSNumber representing the value to fill the tensor.
+ * @param dataType An ExecuTorchDataType value specifying the desired element
+ * type.
+ * @return A new ExecuTorchTensor instance filled with the scalar value.
+ */
++ (instancetype)fullTensorLikeTensor:(ExecuTorchTensor *)tensr
+                              scalar:(NSNumber *)scalar
+                            dataType:(ExecuTorchDataType)dataType
+    NS_SWIFT_UNAVAILABLE("")NS_RETURNS_RETAINED;
+
+/**
+ * Creates a tensor filled with the specified scalar value, similar to an
+ * existing tensor.
+ *
+ * @param tensr An existing ExecuTorchTensor instance.
+ * @param scalar An NSNumber representing the value to fill the tensor.
+ * @return A new ExecuTorchTensor instance filled with the scalar value.
+ */
++ (instancetype)fullTensorLikeTensor:(ExecuTorchTensor *)tensr
+                              scalar:(NSNumber *)scalar
+    NS_SWIFT_UNAVAILABLE("")NS_RETURNS_RETAINED;
+
+@end
+
+#pragma mark - Ones Category
+
+@interface ExecuTorchTensor (Ones)
+
+/**
+ * Creates a tensor filled with ones, with the specified shape, data type, and
+ * shape dynamism.
+ *
+ * @param shape An NSArray of NSNumber objects representing the desired shape.
+ * @param dataType An ExecuTorchDataType value specifying the element type.
+ * @param shapeDynamism An ExecuTorchShapeDynamism value specifying whether the
+ * shape is static or dynamic.
+ * @return A new ExecuTorchTensor instance filled with ones.
+ */
++ (instancetype)onesTensorWithShape:(NSArray<NSNumber *> *)shape
+                           dataType:(ExecuTorchDataType)dataType
+                      shapeDynamism:(ExecuTorchShapeDynamism)shapeDynamism
+    NS_REFINED_FOR_SWIFT NS_RETURNS_RETAINED;
+
+/**
+ * Creates a tensor filled with ones, with the specified shape and data type.
+ *
+ * @param shape An NSArray of NSNumber objects representing the desired shape.
+ * @param dataType An ExecuTorchDataType value specifying the element type.
+ * @return A new ExecuTorchTensor instance filled with ones.
+ */
++ (instancetype)onesTensorWithShape:(NSArray<NSNumber *> *)shape
+                           dataType:(ExecuTorchDataType)dataType
+    NS_SWIFT_UNAVAILABLE("")NS_RETURNS_RETAINED;
+
+/**
+ * Creates a tensor filled with ones similar to an existing tensor, with the
+ * specified data type and shape dynamism.
+ *
+ * @param tensor An existing ExecuTorchTensor instance whose shape and strides
+ * are used.
+ * @param dataType An ExecuTorchDataType value specifying the desired element
+ * type.
+ * @param shapeDynamism An ExecuTorchShapeDynamism value specifying whether the
+ * shape is static or dynamic.
+ * @return A new ExecuTorchTensor instance filled with ones.
+ */
++ (instancetype)onesTensorLikeTensor:(ExecuTorchTensor *)tensor
+                            dataType:(ExecuTorchDataType)dataType
+                       shapeDynamism:(ExecuTorchShapeDynamism)shapeDynamism
+    NS_REFINED_FOR_SWIFT NS_RETURNS_RETAINED;
+
+/**
+ * Creates a tensor filled with ones similar to an existing tensor, with the
+ * specified data type.
+ *
+ * @param tensor An existing ExecuTorchTensor instance whose shape and strides
+ * are used.
+ * @param dataType An ExecuTorchDataType value specifying the desired element
+ * type.
+ * @return A new ExecuTorchTensor instance filled with ones.
+ */
++ (instancetype)onesTensorLikeTensor:(ExecuTorchTensor *)tensor
+                            dataType:(ExecuTorchDataType)dataType
+    NS_SWIFT_UNAVAILABLE("")NS_RETURNS_RETAINED;
+
+/**
+ * Creates a tensor filled with ones similar to an existing tensor.
+ *
+ * @param tensor An existing ExecuTorchTensor instance.
+ * @return A new ExecuTorchTensor instance filled with ones.
+ */
++ (instancetype)onesTensorLikeTensor:(ExecuTorchTensor *)tensor
+    NS_SWIFT_UNAVAILABLE("")NS_RETURNS_RETAINED;
+
+@end
+
+#pragma mark - Zeros Category
+
+@interface ExecuTorchTensor (Zeros)
+
+/**
+ * Creates a tensor filled with zeros, with the specified shape, data type, and
+ * shape dynamism.
+ *
+ * @param shape An NSArray of NSNumber objects representing the desired shape.
+ * @param dataType An ExecuTorchDataType value specifying the element type.
+ * @param shapeDynamism An ExecuTorchShapeDynamism value specifying whether the
+ * shape is static or dynamic.
+ * @return A new ExecuTorchTensor instance filled with zeros.
+ */
++ (instancetype)zerosTensorWithShape:(NSArray<NSNumber *> *)shape
+                            dataType:(ExecuTorchDataType)dataType
+                       shapeDynamism:(ExecuTorchShapeDynamism)shapeDynamism
+    NS_REFINED_FOR_SWIFT NS_RETURNS_RETAINED;
+
+/**
+ * Creates a tensor filled with zeros, with the specified shape and data type.
+ *
+ * @param shape An NSArray of NSNumber objects representing the desired shape.
+ * @param dataType An ExecuTorchDataType value specifying the element type.
+ * @return A new ExecuTorchTensor instance filled with zeros.
+ */
++ (instancetype)zerosTensorWithShape:(NSArray<NSNumber *> *)shape
+                            dataType:(ExecuTorchDataType)dataType
+    NS_SWIFT_UNAVAILABLE("")NS_RETURNS_RETAINED;
+
+/**
+ * Creates a tensor filled with zeros similar to an existing tensor, with the
+ * specified data type and shape dynamism.
+ *
+ * @param tensor An existing ExecuTorchTensor instance whose shape and strides
+ * are used.
+ * @param dataType An ExecuTorchDataType value specifying the desired element
+ * type.
+ * @param shapeDynamism An ExecuTorchShapeDynamism value specifying whether the
+ * shape is static or dynamic.
+ * @return A new ExecuTorchTensor instance filled with zeros.
+ */
++ (instancetype)zerosTensorLikeTensor:(ExecuTorchTensor *)tensor
+                             dataType:(ExecuTorchDataType)dataType
+                        shapeDynamism:(ExecuTorchShapeDynamism)shapeDynamism
+    NS_REFINED_FOR_SWIFT NS_RETURNS_RETAINED;
+
+/**
+ * Creates a tensor filled with zeros similar to an existing tensor, with the
+ * specified data type.
+ *
+ * @param tensor An existing ExecuTorchTensor instance whose shape and strides
+ * are used.
+ * @param dataType An ExecuTorchDataType value specifying the desired element
+ * type.
+ * @return A new ExecuTorchTensor instance filled with zeros.
+ */
++ (instancetype)zerosTensorLikeTensor:(ExecuTorchTensor *)tensor
+                             dataType:(ExecuTorchDataType)dataType
+    NS_SWIFT_UNAVAILABLE("")NS_RETURNS_RETAINED;
+
+/**
+ * Creates a tensor filled with zeros similar to an existing tensor.
+ *
+ * @param tensor An existing ExecuTorchTensor instance.
+ * @return A new ExecuTorchTensor instance filled with zeros.
+ */
++ (instancetype)zerosTensorLikeTensor:(ExecuTorchTensor *)tensor
+    NS_SWIFT_UNAVAILABLE("")NS_RETURNS_RETAINED;
+
+@end
+
+#pragma mark - Random Category
+
+@interface ExecuTorchTensor (Random)
+
+/**
+ * Creates a tensor with random values, with full specification of shape,
+ * strides, data type, and shape dynamism.
+ *
+ * @param shape An NSArray of NSNumber objects representing the desired shape.
+ * @param strides An NSArray of NSNumber objects representing the desired
+ * strides.
+ * @param dataType An ExecuTorchDataType value specifying the element type.
+ * @param shapeDynamism An ExecuTorchShapeDynamism value specifying whether the
+ * shape is static or dynamic.
+ * @return A new ExecuTorchTensor instance filled with random values.
+ */
++ (instancetype)randomTensorWithShape:(NSArray<NSNumber *> *)shape
+                              strides:(NSArray<NSNumber *> *)strides
+                             dataType:(ExecuTorchDataType)dataType
+                        shapeDynamism:(ExecuTorchShapeDynamism)shapeDynamism
+    NS_REFINED_FOR_SWIFT NS_RETURNS_RETAINED;
+
+/**
+ * Creates a tensor with random values, with the specified shape and data type.
+ *
+ * @param shape An NSArray of NSNumber objects representing the desired shape.
+ * @param dataType An ExecuTorchDataType value specifying the element type.
+ * @param shapeDynamism An ExecuTorchShapeDynamism value specifying whether the
+ * shape is static or dynamic.
+ * @return A new ExecuTorchTensor instance filled with random values.
+ */
++ (instancetype)randomTensorWithShape:(NSArray<NSNumber *> *)shape
+                             dataType:(ExecuTorchDataType)dataType
+                        shapeDynamism:(ExecuTorchShapeDynamism)shapeDynamism
+    NS_SWIFT_UNAVAILABLE("")NS_RETURNS_RETAINED;
+
+/**
+ * Creates a tensor with random values, with the specified shape (using dynamic
+ * bound shape) and data type.
+ *
+ * @param shape An NSArray of NSNumber objects representing the desired shape.
+ * @param dataType An ExecuTorchDataType value specifying the element type.
+ * @return A new ExecuTorchTensor instance filled with random values.
+ */
++ (instancetype)randomTensorWithShape:(NSArray<NSNumber *> *)shape
+                             dataType:(ExecuTorchDataType)dataType
+    NS_SWIFT_UNAVAILABLE("")NS_RETURNS_RETAINED;
+
+/**
+ * Creates a tensor with random values similar to an existing tensor, with the
+ * specified data type and shape dynamism.
+ *
+ * @param tensor An existing ExecuTorchTensor instance whose shape and strides
+ * are used.
+ * @param dataType An ExecuTorchDataType value specifying the desired element
+ * type.
+ * @param shapeDynamism An ExecuTorchShapeDynamism value specifying whether the
+ * shape is static or dynamic.
+ * @return A new ExecuTorchTensor instance filled with random values.
+ */
++ (instancetype)randomTensorLikeTensor:(ExecuTorchTensor *)tensor
+                              dataType:(ExecuTorchDataType)dataType
+                         shapeDynamism:(ExecuTorchShapeDynamism)shapeDynamism
+    NS_REFINED_FOR_SWIFT NS_RETURNS_RETAINED;
+
+/**
+ * Creates a tensor with random values similar to an existing tensor, with the
+ * specified data type.
+ *
+ * @param tensor An existing ExecuTorchTensor instance whose shape and strides
+ * are used.
+ * @param dataType An ExecuTorchDataType value specifying the desired element
+ * type.
+ * @return A new ExecuTorchTensor instance filled with random values.
+ */
++ (instancetype)randomTensorLikeTensor:(ExecuTorchTensor *)tensor
+                              dataType:(ExecuTorchDataType)dataType
+    NS_SWIFT_UNAVAILABLE("")NS_RETURNS_RETAINED;
+
+/**
+ * Creates a tensor with random values similar to an existing tensor.
+ *
+ * @param tensor An existing ExecuTorchTensor instance.
+ * @return A new ExecuTorchTensor instance filled with random values.
+ */
++ (instancetype)randomTensorLikeTensor:(ExecuTorchTensor *)tensor
+    NS_SWIFT_UNAVAILABLE("")NS_RETURNS_RETAINED;
+
+@end
+
+#pragma mark - RandomNormal Category
+
+@interface ExecuTorchTensor (RandomNormal)
+
+/**
+ * Creates a tensor with random values drawn from a normal distribution,
+ * with full specification of shape, strides, data type, and shape dynamism.
+ *
+ * @param shape An NSArray of NSNumber objects representing the desired shape.
+ * @param strides An NSArray of NSNumber objects representing the desired
+ * strides.
+ * @param dataType An ExecuTorchDataType value specifying the element type.
+ * @param shapeDynamism An ExecuTorchShapeDynamism value specifying whether the
+ * shape is static or dynamic.
+ * @return A new ExecuTorchTensor instance filled with values from a normal
+ * distribution.
+ */
++ (instancetype)randomNormalTensorWithShape:(NSArray<NSNumber *> *)shape
+                                    strides:(NSArray<NSNumber *> *)strides
+                                   dataType:(ExecuTorchDataType)dataType
+                              shapeDynamism:
+                                  (ExecuTorchShapeDynamism)shapeDynamism
+    NS_REFINED_FOR_SWIFT NS_RETURNS_RETAINED;
+
+/**
+ * Creates a tensor with random values drawn from a normal distribution,
+ * with the specified shape and data type.
+ *
+ * @param shape An NSArray of NSNumber objects representing the desired shape.
+ * @param dataType An ExecuTorchDataType value specifying the element type.
+ * @param shapeDynamism An ExecuTorchShapeDynamism value specifying whether the
+ * shape is static or dynamic.
+ * @return A new ExecuTorchTensor instance filled with values from a normal
+ * distribution.
+ */
++ (instancetype)randomNormalTensorWithShape:(NSArray<NSNumber *> *)shape
+                                   dataType:(ExecuTorchDataType)dataType
+                              shapeDynamism:
+                                  (ExecuTorchShapeDynamism)shapeDynamism
+    NS_SWIFT_UNAVAILABLE("")NS_RETURNS_RETAINED;
+
+/**
+ * Creates a tensor with random values drawn from a normal distribution,
+ * with the specified shape (using dynamic bound shape) and data type.
+ *
+ * @param shape An NSArray of NSNumber objects representing the desired shape.
+ * @param dataType An ExecuTorchDataType value specifying the element type.
+ * @return A new ExecuTorchTensor instance filled with values from a normal
+ * distribution.
+ */
++ (instancetype)randomNormalTensorWithShape:(NSArray<NSNumber *> *)shape
+                                   dataType:(ExecuTorchDataType)dataType
+    NS_SWIFT_UNAVAILABLE("")NS_RETURNS_RETAINED;
+
+/**
+ * Creates a tensor with random normal values similar to an existing tensor,
+ * with the specified data type and shape dynamism.
+ *
+ * @param tensor An existing ExecuTorchTensor instance whose shape and strides
+ * are used.
+ * @param dataType An ExecuTorchDataType value specifying the desired element
+ * type.
+ * @param shapeDynamism An ExecuTorchShapeDynamism value specifying whether the
+ * shape is static or dynamic.
+ * @return A new ExecuTorchTensor instance filled with values from a normal
+ * distribution.
+ */
++ (instancetype)randomNormalTensorLikeTensor:(ExecuTorchTensor *)tensor
+                                    dataType:(ExecuTorchDataType)dataType
+                               shapeDynamism:
+                                   (ExecuTorchShapeDynamism)shapeDynamism
+    NS_REFINED_FOR_SWIFT NS_RETURNS_RETAINED;
+
+/**
+ * Creates a tensor with random normal values similar to an existing tensor,
+ * with the specified data type.
+ *
+ * @param tensor An existing ExecuTorchTensor instance whose shape and strides
+ * are used.
+ * @param dataType An ExecuTorchDataType value specifying the desired element
+ * type.
+ * @return A new ExecuTorchTensor instance filled with values from a normal
+ * distribution.
+ */
++ (instancetype)randomNormalTensorLikeTensor:(ExecuTorchTensor *)tensor
+                                    dataType:(ExecuTorchDataType)dataType
+    NS_SWIFT_UNAVAILABLE("")NS_RETURNS_RETAINED;
+
+/**
+ * Creates a tensor with random normal values similar to an existing tensor.
+ *
+ * @param tensor An existing ExecuTorchTensor instance.
+ * @return A new ExecuTorchTensor instance filled with values from a normal
+ * distribution.
+ */
++ (instancetype)randomNormalTensorLikeTensor:(ExecuTorchTensor *)tensor
+    NS_SWIFT_UNAVAILABLE("")NS_RETURNS_RETAINED;
+
+@end
+
+#pragma mark - RandomInteger Category
+
+@interface ExecuTorchTensor (RandomInteger)
+
+/**
+ * Creates a tensor with random integer values in the specified range,
+ * with full specification of shape, strides, data type, and shape dynamism.
+ *
+ * @param low An NSInteger specifying the inclusive lower bound of random
+ * values.
+ * @param high An NSInteger specifying the exclusive upper bound of random
+ * values.
+ * @param shape An NSArray of NSNumber objects representing the desired shape.
+ * @param strides An NSArray of NSNumber objects representing the desired
+ * strides.
+ * @param dataType An ExecuTorchDataType value specifying the element type.
+ * @param shapeDynamism An ExecuTorchShapeDynamism value specifying whether the
+ * shape is static or dynamic.
+ * @return A new ExecuTorchTensor instance filled with random integer values.
+ */
++ (instancetype)randomIntegerTensorWithLow:(NSInteger)low
+                                      high:(NSInteger)high
+                                     shape:(NSArray<NSNumber *> *)shape
+                                   strides:(NSArray<NSNumber *> *)strides
+                                  dataType:(ExecuTorchDataType)dataType
+                             shapeDynamism:
+                                 (ExecuTorchShapeDynamism)shapeDynamism
+    NS_REFINED_FOR_SWIFT NS_RETURNS_RETAINED;
+
+/**
+ * Creates a tensor with random integer values in the specified range,
+ * with the given shape and data type.
+ *
+ * @param low An NSInteger specifying the inclusive lower bound of random
+ * values.
+ * @param high An NSInteger specifying the exclusive upper bound of random
+ * values.
+ * @param shape An NSArray of NSNumber objects representing the desired shape.
+ * @param dataType An ExecuTorchDataType value specifying the element type.
+ * @param shapeDynamism An ExecuTorchShapeDynamism value specifying whether the
+ * shape is static or dynamic.
+ * @return A new ExecuTorchTensor instance filled with random integer values.
+ */
++ (instancetype)randomIntegerTensorWithLow:(NSInteger)low
+                                      high:(NSInteger)high
+                                     shape:(NSArray<NSNumber *> *)shape
+                                  dataType:(ExecuTorchDataType)dataType
+                             shapeDynamism:
+                                 (ExecuTorchShapeDynamism)shapeDynamism
+    NS_SWIFT_UNAVAILABLE("")NS_RETURNS_RETAINED;
+
+/**
+ * Creates a tensor with random integer values in the specified range,
+ * with the given shape (using dynamic bound shape) and data type.
+ *
+ * @param low An NSInteger specifying the inclusive lower bound of random
+ * values.
+ * @param high An NSInteger specifying the exclusive upper bound of random
+ * values.
+ * @param shape An NSArray of NSNumber objects representing the desired shape.
+ * @param dataType An ExecuTorchDataType value specifying the element type.
+ * @return A new ExecuTorchTensor instance filled with random integer values.
+ */
++ (instancetype)randomIntegerTensorWithLow:(NSInteger)low
+                                      high:(NSInteger)high
+                                     shape:(NSArray<NSNumber *> *)shape
+                                  dataType:(ExecuTorchDataType)dataType
+    NS_SWIFT_UNAVAILABLE("")NS_RETURNS_RETAINED;
+
+/**
+ * Creates a tensor with random integer values in the specified range, similar
+ * to an existing tensor, with the given data type and shape dynamism.
+ *
+ * @param tensor An existing ExecuTorchTensor instance whose shape and strides
+ * are used.
+ * @param low An NSInteger specifying the inclusive lower bound of random
+ * values.
+ * @param high An NSInteger specifying the exclusive upper bound of random
+ * values.
+ * @param dataType An ExecuTorchDataType value specifying the element type.
+ * @param shapeDynamism An ExecuTorchShapeDynamism value specifying whether the
+ * shape is static or dynamic.
+ * @return A new ExecuTorchTensor instance filled with random integer values.
+ */
++ (instancetype)randomIntegerTensorLikeTensor:(ExecuTorchTensor *)tensor
+                                          low:(NSInteger)low
+                                         high:(NSInteger)high
+                                     dataType:(ExecuTorchDataType)dataType
+                                shapeDynamism:
+                                    (ExecuTorchShapeDynamism)shapeDynamism
+    NS_REFINED_FOR_SWIFT NS_RETURNS_RETAINED;
+
+/**
+ * Creates a tensor with random integer values in the specified range, similar
+ * to an existing tensor, with the given data type.
+ *
+ * @param tensor An existing ExecuTorchTensor instance whose shape and strides
+ * are used.
+ * @param low An NSInteger specifying the inclusive lower bound of random
+ * values.
+ * @param high An NSInteger specifying the exclusive upper bound of random
+ * values.
+ * @param dataType An ExecuTorchDataType value specifying the element type.
+ * @return A new ExecuTorchTensor instance filled with random integer values.
+ */
++ (instancetype)randomIntegerTensorLikeTensor:(ExecuTorchTensor *)tensor
+                                          low:(NSInteger)low
+                                         high:(NSInteger)high
+                                     dataType:(ExecuTorchDataType)dataType
+    NS_SWIFT_UNAVAILABLE("")NS_RETURNS_RETAINED;
+
+/**
+ * Creates a tensor with random integer values in the specified range, similar
+ * to an existing tensor.
+ *
+ * @param tensor An existing ExecuTorchTensor instance.
+ * @param low An NSInteger specifying the inclusive lower bound of random
+ * values.
+ * @param high An NSInteger specifying the exclusive upper bound of random
+ * values.
+ * @return A new ExecuTorchTensor instance filled with random integer values.
+ */
++ (instancetype)randomIntegerTensorLikeTensor:(ExecuTorchTensor *)tensor
+                                          low:(NSInteger)low
+                                         high:(NSInteger)high
+    NS_SWIFT_UNAVAILABLE("")NS_RETURNS_RETAINED;
+
+@end
+
 NS_ASSUME_NONNULL_END