numpy-ts 0.5.0 → 0.7.0

package/dist/types/core/broadcasting.d.ts

@@ -54,6 +54,24 @@ export declare function broadcastTo(storage: ArrayStorage, targetShape: readonly
  * @throws Error if arrays have incompatible shapes
  */
 export declare function broadcastArrays(storages: ArrayStorage[]): ArrayStorage[];
+/**
+ * Compute the broadcast shape for multiple shapes without creating arrays.
+ * Returns the resulting shape if all shapes are broadcast-compatible.
+ *
+ * This is the NumPy-compatible function for computing broadcast shape.
+ *
+ * @param shapes - Variable number of shapes to broadcast
+ * @returns The broadcast output shape
+ * @throws Error if shapes are not broadcast-compatible
+ *
+ * @example
+ * ```typescript
+ * broadcastShapes([3, 4], [4]);      // [3, 4]
+ * broadcastShapes([3, 4], [3, 1]);   // [3, 4]
+ * broadcastShapes([3, 4], [5]);      // Error
+ * ```
+ */
+export declare function broadcastShapes(...shapes: readonly number[][]): number[];
 /**
  * Generate a descriptive error message for broadcasting failures
  *